Documentation for Streamlining the process of Integrating existing MCP server into a Hubspot Database

• Hubspot access token containing required read/write permissions on a private app.
• Cursor Application to access the MCP server and talk with LLM.

1. Go to Hubspot and make an account.
2. In Hubspot, Open Settings > Integrations > Create private app.
3. Provide the Basic Information of the private app.
4. In scopes, click Add new scope make sure the following are selected:

• crm.objects.contacts (read and write)
• crm.objects.companies (read and write)

5. After the scopes are added, click Create app.
6. Again open Private apps and view access token. Save it in a secure place. We will use it in the MCP Integration.

1. Download Cursor and setup the project folder.
2. Go to settings > MCP > add new global MCP Server
3. Paste the following in it, and make sure to include your Hubspot Access token:

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "buryhuang/mcp-hubspot:latest",
        "--access-token",
        "<Your Access Token here>"
      ]
    }
  }
}

We can use the below prompts to check if everything went well or failed.

Test if the current access token is valid by making a minimal authenticated request to the HubSpot MCP Server.

Create a Company with the following data:
name: Nimbus Technologies
description: Cloud infrastructure & AI services ☁️🤖
domain: nimbustech.ai
phone: +1-800-555-0199
website: https://www.nimbustech.ai
address: 123 Innovation Way
city: San Francisco
state: CA
zip: 94107
country: USA
industry: INFORMATION_TECHNOLOGY_AND_SERVICES
type: PROSPECT
numberofemployees: 4200
annualrevenue: 125000000

• Big thanks to baryhuang for creating the docker integration.
• The original Hubspot CRM - MCP Server is done by peakmojo.