Hubspot MCP

🚀 Optimization Document for Integrating Existing MCP Servers into Hubspot Database 🤖

This document provides a detailed guide on optimizing the process of integrating an existing MCP server into the Hubspot database. It includes prerequisites, configuration steps on both Hubspot and Cursor, access permission checks, and acknowledgments.

📋 Prerequisites

• A Hubspot access token with read/write permissions (required for private applications).
• The Cursor application installed and running to access the MCP server and interact with the LLM.

⚙️ Configuration on Hubspot

1. Visit Hubspot and create an account.
2. In Hubspot, go to Settings > Integrations > Create a private app.
3. Provide basic information for the private app.
4. Click Scope, add a new scope, and ensure the following permissions are selected:
   • crm.objects.contacts (read and write)
   • crm.objects.companies (read and write)
5. After adding the scope, click Create app.
6. Return to the Private apps page, view, and save the generated access token. This token will be used for subsequent MCP integration.

⚙️ Configuration on Cursor

1. Download Cursor and set up the project folder.
2. Go to Settings > MCP > Add a new global MCP server.
3. Paste the following content in the appropriate location, 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 Permission Check

We can use the following prompt statements to verify whether the integration is successful or if any issues are encountered.

Verify the validity of the access token

Test the validity of the current access token by sending a minimal authentication request to the HubSpot MCP server.

Test data input for checking

Create a company using the following data:
Name: nimbus Technologies
Description: Cloud infrastructure and AI services ☁️🤖
Domain: nimbustech.ai
Phone: +1-800-555-0199
Website: https://www.nimbustech.ai
Address: 123 Innovation Avenue
City: San Francisco
State: CA
Zip Code: 94107
Country: United States
Industry: Information Technology and Services
Type: Prospect
Number of Employees: 4200
Annual Revenue: 125,000,000

Values reflected in the Hubspot database:

🙏 Acknowledgments

• Thanks to baryhuang for creating the Docker integration.
• The original Hubspot CRM - MCP server was created by peakmojo.