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 ToolsInstead 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.comWhat 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.comYou 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/cliCheck the version:
hs --versionHubSpot currently requires CLI version 8.2.0 or higher for the latest supported MCP clients.
Then run:
hs mcp setupSelect your preferred development client and complete the setup.
After restarting the client if required, you should see the HubSpot MCP server listed as:
HubSpotDevWhat 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.
Frequently Asked Questions
What is the HubSpot MCP Server?
The HubSpot MCP Server allows MCP-compatible AI applications to interact with supported HubSpot data and tools. HubSpot provides a Remote MCP Server for CRM data and a separate Developer MCP Server for development tasks.
Is HubSpot MCP available in 2026?
Yes. HubSpot’s Remote MCP Server and Developer MCP Server are both generally available in 2026.
What is the HubSpot MCP Server URL?
The official Remote MCP endpoint is:
https://mcp.hubspot.comCan HubSpot MCP create or update CRM records?
Yes. The Remote MCP Server supports write operations for several supported CRM objects and activities, subject to the authenticated user’s HubSpot permissions.
Can I use HubSpot MCP with Cursor?
Yes. Cursor is one of the clients officially supported by HubSpot’s Developer MCP setup.
Can I use HubSpot MCP with Codex?
Yes. HubSpot currently lists Codex CLI as a supported client for the Developer MCP Server.
Does HubSpot MCP replace the HubSpot API?
No. MCP is useful for AI-driven workflows, while traditional HubSpot APIs remain better suited to many integrations, webhooks, bulk data operations, and deterministic backend processes.
Is HubSpot MCP secure?
The Remote MCP Server uses OAuth with PKCE and respects existing HubSpot user permissions. Developers should still use normal security practices and require confirmation for sensitive actions.
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.