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

Pre-requisites

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

Setting up Hubspot

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.

Setting up Cursor

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>"
      ]
    }
  }
}

Access Check

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

Check the Access Token Validity

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

Input Test Data to check

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

Reflected Values in Hubspot database:

Credits

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