HubSpot MCP Server

An MCP server that exposes HubSpot CRM operations as tools over stdio, so any MCP client can query and modify your HubSpot data.

Tools

Setup

1. Install and build:

   npm install
   npm run build
   

2. In HubSpot, create a Private App (Settings -> Integrations -> Private Apps) and grant the CRM scopes you need (contacts read/write, deals read/write, companies read). Copy its access token.

3. Configure credentials:

   cp .env.example .env
   # then edit .env and paste your token into HUBSPOT_ACCESS_TOKEN
   

4. Run:

   npm start        # runs dist/index.js
   # or during development:
   npm run dev
   

   You should see HubSpot MCP server running on stdio.

Using with VS Code Copilot (incl. Codespaces)

Create .vscode/mcp.json in your workspace root:

{
  "servers": {
    "hubspot": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/dist/index.js"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "${input:hubspot_token}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "hubspot_token",
      "description": "HubSpot Private App access token",
      "password": true
    }
  ]
}

Open the file, click Start above the server entry, switch Copilot Chat to Agent mode, and the HubSpot tools appear.

Using with Claude Desktop

{
  "mcpServers": {
    "hubspot": {
      "command": "node",
      "args": ["/absolute/path/to/hubspot-mcp/dist/index.js"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your_private_app_access_token"
      }
    }
  }
}

Notes

• Auth is a single static bearer token (the Private App access token) — no OAuth exchange needed.
• listDeals uses HubSpot's search endpoint when a stage filter is supplied, and a plain paginated list otherwise.
• Deal stages and pipelines are referenced by their internal ids, which differ per portal — check Settings -> Objects -> Deals -> Pipelines.