HubSpot MCP Server: Complete Developer Guide for 2026

Last updated: August 2026

The HubSpot MCP Server allows AI assistants and development tools to securely interact with HubSpot using the Model Context Protocol (MCP).

For developers, this can mean asking an AI assistant to find CRM records, summarize sales activity, create supported CRM data, search HubSpot documentation, build an app, validate a project, or review build errors — without manually handling every API request or CLI command.

The most important thing to understand is that HubSpot currently provides two different MCP servers: one for CRM data and another for HubSpot development.

Quick Summary

• Remote HubSpot MCP Server: Use it when an AI assistant needs access to HubSpot CRM, activities, marketing, content, or other supported account data.
• HubSpot Developer MCP Server: Use it when you want an AI coding assistant to help build HubSpot apps, CMS assets, serverless functions, or developer projects.
• The Remote MCP Server is hosted by HubSpot at https://mcp.hubspot.com.
• Remote MCP uses OAuth with PKCE and follows the authenticated user’s HubSpot permissions.
• The Developer MCP Server runs locally through the HubSpot CLI.
• MCP does not replace the HubSpot API. APIs are still better for many structured integrations, bulk operations, and webhook-driven processes.

What Is MCP?

MCP stands for Model Context Protocol. It is an open standard that helps AI applications connect to external systems, tools, and data through a consistent interface.

A simple way to understand it is:

AI Assistant
     ↓
MCP
     ↓
HubSpot
     ↓
CRM Data / Developer Tools

Instead of teaching an AI assistant how every HubSpot API endpoint works, an MCP server can expose specific tools that the assistant is allowed to use.

For example, an AI assistant could use a HubSpot MCP tool to search for a company, retrieve related deals, and summarize recent activity.

What Is the HubSpot MCP Server?

The HubSpot MCP Server connects MCP-compatible AI tools with HubSpot.

However, HubSpot provides two separate versions for different purposes.

Feature	Remote MCP Server	Developer MCP Server
Purpose	Access HubSpot CRM and account data	Build HubSpot apps and CMS projects
Runs	On HubSpot	Locally
Best for	AI assistants and CRM agents	Developers and AI coding tools
Example	Find a company and summarize its recent deals	Create a HubSpot CRM card

1. HubSpot Remote MCP Server

The Remote MCP Server is the option to use when your AI application needs access to actual HubSpot CRM or business data.

The official endpoint is:

https://mcp.hubspot.com

What can it access?

Depending on permissions and available tools, HubSpot currently supports access to data such as:

• Contacts
• Companies
• Deals
• Tickets
• Calls, emails, meetings, notes, and tasks
• Products and line items
• Orders and invoices
• Marketing events
• Landing pages and website pages
• Blog posts
• Campaigns
• Marketing email data
• Conversations

It also supports write operations for several CRM objects and activities, including contacts, companies, deals, tickets, tasks, notes, meetings, and other supported records.

How to Set Up Remote HubSpot MCP

Step 1: Create an MCP Auth App

Inside HubSpot, go to the developer area and create an MCP Auth App.

You will configure:

• App name
• Redirect URL
• OAuth credentials

Step 2: Connect Your MCP Client

Configure your MCP-compatible application to connect to:

https://mcp.hubspot.com

You will normally need:

• Client ID
• Client secret
• Redirect URL

Step 3: Authenticate with OAuth + PKCE

HubSpot requires OAuth with PKCE for Remote MCP connections.

Some MCP clients handle PKCE automatically. If you are building your own client, you need to implement the OAuth flow correctly.

Step 4: Start Using Natural-Language Requests

Once connected, your AI assistant can use the available HubSpot tools.

For example:

Find Acme Inc. in HubSpot and summarize its open deals and latest sales activities.

Or:

Create a follow-up task for the owner of this deal.

2. HubSpot Developer MCP Server

The Developer MCP Server solves a completely different problem.

Instead of giving an AI assistant access to CRM records, it gives your coding assistant HubSpot development tools and access to current HubSpot developer documentation.

This is especially useful when working in tools such as:

• Cursor
• VS Code
• Codex CLI
• Claude Code
• Gemini CLI
• Windsurf

Developer MCP Setup

First, make sure the HubSpot CLI is installed:

npm install -g @hubspot/cli

Check the version:

hs --version

HubSpot currently requires CLI version 8.2.0 or higher for the latest supported MCP clients.

Then run:

hs mcp setup

Select your preferred development client and complete the setup.

After restarting the client if required, you should see the HubSpot MCP server listed as:

HubSpotDev

What Can Developer MCP Actually Do?

This is where the Developer MCP Server becomes useful in everyday HubSpot development.

It can help your AI coding assistant:

• Search official HubSpot developer documentation
• Fetch the latest documentation before generating code
• Create HubSpot projects
• Create CRM cards and settings pages
• Add webhooks and workflow actions
• Create CMS templates and modules
• Create serverless functions
• Validate project configuration
• Check HubSpot build status
• Review build errors and logs
• Upload HubSpot projects
• Deploy builds when explicitly requested

For example, instead of manually searching the documentation and creating project files, you could ask:

Search the latest HubSpot documentation and create a HubSpot app with a CRM card and settings page.

Or:

Check my latest HubSpot build, review the errors, and explain how to fix them.

Remote MCP or Developer MCP: Which One Should You Use?

If You Want To…	Use
Search CRM contacts or companies	Remote MCP
Analyze deals or activities	Remote MCP
Create or update supported CRM records	Remote MCP
Build a HubSpot app	Developer MCP
Create a CRM card	Developer MCP
Build CMS modules or templates	Developer MCP
Debug project builds	Developer MCP

HubSpot MCP vs HubSpot API

MCP does not replace the traditional HubSpot API.

Think of MCP as an AI-friendly way of accessing supported HubSpot capabilities, while the API gives developers direct and predictable control.

Use MCP when:

• You are building an AI assistant or agent
• Users want to interact with HubSpot through natural language
• You want an AI coding assistant to understand HubSpot development
• The required functionality is already available through MCP tools

Use the HubSpot API when:

• You need large-scale data synchronization
• You need webhook-based automation
• You need exact request and response control
• You need an API feature that MCP does not expose
• Your business logic needs to run predictably without AI reasoning

In real applications, using MCP and HubSpot APIs together will often make more sense than choosing only one.

Security and Limitations

Giving an AI assistant CRM access should be treated carefully.

Keep these points in mind:

• HubSpot permissions still apply. Remote MCP respects the authenticated user’s existing HubSpot permissions.
• Not every HubSpot API is available through MCP. You can only use the tools HubSpot currently exposes.
• Remote MCP does not currently provide vector search.
• Sensitive Data settings can restrict access. HubSpot can block activity and conversation data from MCP when Sensitive Data is enabled.
• Use confirmation for important actions. Publishing content, changing important CRM data, uploading projects, or deploying code should have appropriate human control.

Practical HubSpot MCP Examples

Here are a few realistic prompts a developer or CRM team could use:

CRM Research

Find this company in HubSpot, show its open deals, and summarize its latest activity.

Sales Preparation

Summarize the latest calls, meetings, and emails with this prospect.

HubSpot Development

Search HubSpot’s latest documentation and create a CRM card for deal records.

Project Debugging

Check the latest project build and help me fix any errors.

CMS Development

Create a reusable HubSpot React module for a testimonial section.

Why HubSpot MCP Matters in 2026

HubSpot’s MCP support has moved beyond a simple experiment.

The Remote MCP Server is generally available and supports both read and write capabilities, while the Developer MCP Server can perform practical development tasks such as project creation, validation, debugging, uploads, and deployments.

For HubSpot developers, the biggest advantage is not simply writing code faster. It is giving AI tools better HubSpot context so they can use current documentation and supported platform tools instead of relying only on general AI knowledge.

https://mcp.hubspot.com

Final Thoughts

The easiest way to think about HubSpot MCP is this:

Remote MCP connects AI to your HubSpot CRM.

Developer MCP connects AI coding tools to the HubSpot Developer Platform.

If you are building AI-powered CRM experiences, Remote MCP is the place to start. If you regularly build HubSpot apps, CRM cards, workflow extensions, CMS modules, or serverless functions, Developer MCP can significantly improve your development workflow.

And when you need predictable integrations, bulk processing, or webhook-driven automation, continue using the HubSpot APIs alongside MCP.

Official References

• HubSpot Developers — Remote HubSpot MCP Server
• HubSpot Developers — Set Up the Developer MCP Server
• HubSpot Developers — Developer MCP Server Tools
• HubSpot Developers — Remote MCP General Availability
• Model Context Protocol — Official Documentation
• WordPress.org — Custom HTML Block Documentation