The HubSpot MCP server is now available in public beta. It allows AI clients such as Cursor and Claude to interact with HubSpot data and unlocks powerful integration possibilities.

What is MCP?

MCP (Model Context Protocol) is an emerging standard that allows AI models to interact with applications through a consistent interface. It acts as an abstraction layer over traditional APIs, letting AI agents access application functionality without needing to understand specific API protocols. 

What does the HubSpot MCP Server do?

Interact with business-critical tools, such as HubSpot’s Smart CRM, through natural language AI applications like Claude Desktop to create and update objects, notes, and tasks tied to the way your business operates.

The current MCP tools in this server  enable you to: 

• Retrieve, create, or update HubSpot objects
• List HubSpot objects and their properties
• Access and create associations between objects
• Create tasks and notes in your HubSpot account
• Open specific screens within the HubSpot UI
• Provide feedback on the MCP server through natural language 

To help put it into perspective here are some examples of prompts that your AI client could handle with the HubSpot MCP Server.

Streamline your development

• "Get the company record for Google and place it in a JSON file that I can reference in my code as a placeholder as work on the UI for my UI Extension, website module, and template."
• "I don't know if the sales reps have been using a custom property called "Serial number" properly can you fetch 100 part records and let me know what data type that property is, and any rules that seem to apply to that data so I can create a regex in my application to ensure consistency?"
• "I just ran a serverless function locally and want to test that the record is properly updated. Can you look at my log to see which record I updated and then look up that record in my CRM to see if that change is reflected?"

Get insights from your HubSpot data

• "Get me the latest update about Acme Inc. from my HubSpot account."
• "Summarize all deals in the “Decision maker bought in” stage in my HubSpot pipeline with deal value > $1000."
• "Summarize the last five tickets created for Alex Smith in my HubSpot account"

Create and update CRM records

• "Update the address for John Smith in my HubSpot account"
• "Create a new contact “John.Johnson@email.com” for Acme Inc. in my HubSpot account."

CRM associations

• "List all associated contacts and their roles for Acme Inc, from my HubSpot account."
• "List associated contacts for Acme Inc in my HubSpot account"
• "Associate John Smith with Acme Inc. as a company in my HubSpot account"

Add engagements

• "Add a task to send a thank-you note to jane@example.com in my HubSpot account"
• "Add a note for Acme. Inc. in my HubSpot account"
• "List my overdue HubSpot tasks"

• “From my HubSpot account, find the number of contacts <company-name> has.”

Get started

The HubSpot MCP server is available as an NPM package that you can easily install and configure. To get started, all you need to do is copy the configuration JSON to your client apps (for example, Claude desktop) with your HubSpot private app access token. 

Learn more about the HubSpot MCP Server

Get Involved

HubSpot’s MCP public beta is only the beginning. We want your feedback on the use cases you build and the problems you solve. Alternatively, use a prompt, like “provide feedback for the HubSpot MCP Server” from your client application!

Additionally join us in a discussion in the developer forums. We'd love to hear what you use it for.

Note: LLM's are prone to hallucination, always review when prompted for permission to use an MCP tool that makes changes to your account, if those changes reflect what you requested. If you'd like to experiment with full write and delete permissions we recommend doing so in a developer sandbox or other non-production account. This product will evolve to include more functionality and an improved authentication system.