HubSpot MCP Server
Official HubSpot MCP server: read and write contacts, companies, deals, pipelines, and marketing data directly from your AI client — secured via OAuth.
- Skill Road
- HubSpot MCP Server
Categories
Description
The HubSpot MCP Server is the official Model Context Protocol server from HubSpot, Inc. for the eponymous Smart CRM. It gives compatible AI clients — including Claude, Cursor, Codex, and other MCP-capable tools — secure read and write access to CRM objects, marketing content, and conversation data without requiring users to understand the underlying HubSpot API. The direct product link is https://developers.hubspot.com/ai-tools/mcp; the open-source repository lives at https://github.com/HubSpot/mcp-server.
What is the HubSpot MCP Server?
According to the provider, HubSpot operates two separate MCP servers: the Remote MCP Server at https://mcp.hubspot.com, secured by OAuth 2.1 with PKCE and exposing CRM data from a HubSpot account, and the Developer MCP Server for local development tasks on the HubSpot developer platform. This catalog entry describes the remote server (with an optional local NPM package) for productive CRM access. The Model Context Protocol (MCP) is an open standard that connects AI applications to external tools and data sources: when an agent receives a HubSpot-relevant prompt, the MCP client delegates the request to the server, which calls the HubSpot API and returns structured results.
Prerequisites
Using the HubSpot MCP Server requires: an active HubSpot account (free or paid), a compatible MCP client (Claude Desktop, Cursor, Codex, or another MCP-capable client), and OAuth consent with PKCE for the remote server. For the local NPM package, Node.js is required along with a HubSpot Private App Access Token. PKCE (Proof Key for Code Exchange) is mandatory for authenticating with the remote server; some clients such as the MCP Inspector handle PKCE automatically. Custom integrations must explicitly support OAuth 2.1 with PKCE.
Features and Tools
The HubSpot MCP Server provides extensive read and write capabilities according to official documentation:
Contacts: Read, create, and update contact records including properties, associations, and activities. Typical prompts: "Show me the contact for John Smith" or "Create a new contact for jane@example.com at Acme Inc."
Companies: Access company profiles, properties, and associated contacts. Associations between objects can be created via natural language, e.g., "Associate John Smith with Acme Inc. as a company."
Deals: Retrieve and edit deals across pipeline stages, with filtering by deal value, stage, or owner. Example: "Summarize all deals in the Decision-Maker-Bought-In stage with a value over $1,000."
Pipelines: Overview of pipeline stages, deal distribution, and forecasting data via natural-language queries.
Tickets and Leads: Create and update support tickets and lead records for sales workflows.
Activities: Create and retrieve call, email, meeting, note, and task records. Examples: "Add a task to send jane@example.com a thank-you note" or "List my overdue HubSpot tasks."
Marketing and Content: Read and write access to blog posts, landing pages, site pages, campaigns, marketing events, and email analytics (sends, opens, clicks, bounces).
Conversations: Access to conversations from live chat, team email, WhatsApp, SMS, Facebook Messenger, and other connected channels (subject to inbox configuration and user permissions).
User and Account Data: Details about the authenticated user, account information, and organization-wide data such as teams, job titles, and seat counts.
Setup
For the remote server: create an MCP auth app in your HubSpot account under Developer Tools, note the OAuth credentials (client ID), then point your MCP client at https://mcp.hubspot.com. Authentication flows via OAuth 2.1 with PKCE; after granting consent, all tools available in the MCP server become accessible. Permissions are determined automatically by the tools available in the server and the scopes chosen during installation.
For the local NPM package (development variant): npm install -g @hubspot/mcp-server and set the HubSpot Private App Access Token in the client configuration. Claude Desktop adds the start command to claude_desktop_config.json; Cursor uses a JSON configuration at ~/.cursor/mcp.json.
Available scopes are not explicitly defined by the app configuration but are automatically determined by the tools present in the MCP server and the permissions the user chooses to grant during installation. When HubSpot updates scopes, already-installed apps must be reinstalled to grant any new scopes.
Security
The HubSpot MCP Server supports write access to live CRM data according to the provider: creating and updating contacts, companies, deals, tickets, line items, products, activities, and content assets. All actions respect the user permissions configured in the HubSpot account — a user can only view and modify records they have access to in the HubSpot UI. PKCE is mandatory for the remote server; API tokens for the local NPM package belong in environment variables or secure client configurations, not in public repositories. Prompt injection via manipulated CRM data (e.g., contact names or note content) is a known risk for MCP servers with CRM access; agent outputs should be reviewed before any productive write operations. HubSpot explicitly notes that LLMs are prone to hallucination and outputs should always be reviewed.
FAQ
Is the HubSpot MCP Server free? The NPM package is open source. Usage costs depend on the HubSpot account plan and AI client. Current pricing information is available at https://www.hubspot.com/pricing.
What HubSpot CRM data is accessible? According to the provider: contacts, companies, deals, tickets, leads, users, carts, invoices, orders, line items, products, quotes, subscriptions, custom objects, and segments (read access), plus write access to the main CRM objects and activities.
Is OAuth mandatory? For the remote server, yes — OAuth 2.1 with PKCE is required. The local NPM package accepts a HubSpot Private App Access Token.
What distinguishes the remote and developer MCP servers? The remote server at mcp.hubspot.com is intended for productive CRM access. The Developer MCP Server helps developers build HubSpot apps and CMS content locally on the HubSpot developer platform — it is a separate product.
How current are the GitHub stars? The GitHub API reported exactly 5 stars for the repository HubSpot/mcp-server on 2026-09-08. That number is a point-in-time snapshot and is not a quality or security promise.
Requirements
HubSpot account, MCP client (Claude Desktop, Cursor, Codex, or similar), and OAuth 2.1 with PKCE for the remote server or a HubSpot Private App Access Token for the local NPM package.
Installation instructions
The HubSpot MCP Server is, according to HubSpot, the official way to connect compatible AI clients to HubSpot CRM data. MCP stands for Model Context Protocol, a standard that lets an agent reach external tools and data sources. The key point for visitors is that the server can read data and, depending on permissions, change live CRM records. Setup should therefore be treated as a security-relevant integration, not merely a convenience feature.
Quick start
Remote: create an MCP auth app in your HubSpot account, point your MCP client at https://mcp.hubspot.com, grant OAuth consent with PKCE. Local: npm install -g @hubspot/mcp-server and set the Private App Access Token in the client configuration.
npm install -g @hubspot/mcp-server
Step 1: Remote server, local variant, and prerequisites
HubSpot describes a Remote MCP Server for CRM access and a separate Developer MCP Server for development tasks on the HubSpot platform. This guide focuses on CRM access. For the remote server, you need a HubSpot account, an MCP-capable client, and OAuth consent with PKCE. PKCE is a protection mechanism in the OAuth flow that helps prevent an intercepted authorization code from being abused. Many users will not implement it themselves, but they should confirm that their client supports it.
For local or non-interactive setups, HubSpot provides an NPM package. That path requires Node.js and a HubSpot Private App Access Token. A token is a technical key and must not appear in repositories, chat logs, sample configuration, or screenshots. Where possible, the remote server with OAuth is preferable because user consent and permissions are easier to trace.
Step 2: Set up with minimal risk
Start with a clearly limited test account or controlled environment when possible. Create the required HubSpot authentication context, connect the MCP client to the HubSpot endpoint, and complete OAuth consent. Do not immediately create or modify a record. Run a harmless read operation first, such as retrieving account information or a small contact list. This verifies connection, authentication, and output before any write action is considered.
Document which client was connected, which HubSpot account is affected, and who granted consent. In teams, this matters because later agent runs otherwise become hard to audit. If you use the local package, place the token in a secure client configuration or environment variable and restrict the Private App permissions to the actual purpose.
Tools and practical value
According to HubSpot, the MCP Server can access core CRM objects, including contacts, companies, deals, tickets, leads, activities, and marketing or content data. In practice, an agent can answer questions such as which open deals belong to a company, which tasks are overdue, or which contacts are associated with an account. With sufficient authorization, it can also create new records or update existing ones.
The value comes from natural language and reduced context switching. Sales, support, or marketing users do not need to know API endpoints to retrieve structured information. The same convenience creates risk. An ambiguous prompt, model hallucination, or manipulated CRM field can lead to wrong suggestions. For write operations, include a human review step before the change is applied.
Permissions, data, and prompt injection
HubSpot states that actions respect the user permissions configured in the HubSpot account. That is important, but it is not enough by itself. A user with broad permissions can still create broad impact through the MCP server. Apply least privilege, clear scopes, and separate roles for testing and production use. Review authorized apps regularly and remove old connections when they are no longer needed.
Prompt injection is a real risk with CRM data. A contact name, note, or ticket description can contain instructions intended to influence the agent. Such content is data, not a command. The agent may summarize or process it, but it should not treat it as a new system instruction. Require human confirmation before changes to customer data, deals, or marketing content.
Limits and day-to-day operation
The HubSpot MCP Server does not replace CRM governance, data stewardship, or business judgment. It makes access and automation easier, but it cannot magically correct false or incomplete data. Large changes, bulk updates, and confidential customer information require additional controls. Actual model processing also depends on the chosen AI client; HubSpot provides CRM connectivity, while the client may transmit data to its model provider.
A good rollout starts in three steps: test a safe read tool, review permissions, then perform one small approved write action and read it back. Only after that chain is traceable should the server be placed into recurring workflows.
npm install -g @hubspot/mcp-server
Authentication
OAuth 2.1 with PKCE (remote server, recommended) or HubSpot Private App Access Token (local NPM package).
Required access permissions
Permissions follow HubSpot user rights and the scopes chosen during OAuth consent; write access to live CRM data is possible.
Transmitted or stored data
Tool calls reach the HubSpot API and return structured results to the MCP client; data does not leave the HubSpot platform additionally.
Security risks
Write access to live CRM data, prompt injection via manipulated CRM content, API tokens in insecure configurations, LLM hallucinations.
License and costs
- License
- Not recorded yet.
- Cost
- free
The NPM package is open source. Costs depend on the HubSpot account plan and AI client. Current pricing at hubspot.com/pricing.
Alternatives
Not recorded yet.
At a glance
- Provider
- HubSpot
- Status
- Official server
- Deployment
- Local and remote
- Current version
- Not recorded yet.
- GitHub stars
- 6
- Last reviewed
- 08.09.2026
Repository and documentation
Categories
Supported clients
Related guides
Guides and background related to this entry.
No related guides yet.