HubSpot MCP Server

Install HubSpot MCP Server in your MCP client

HubSpot MCP Server is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

1. Locate your client's MCP config file.
   • Cursor: ~/.cursor/mcp.json
   • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
   • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
   • VS Code: Settings → Extensions → MCP
   • Windsurf: Settings → MCP Servers
2. Add HubSpot MCP Server to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
3. Restart your client so it picks up the new server.
4. Verify — ask the assistant to list available tools; HubSpot MCP Server's tools should appear.

{
  "mcpServers": {
    "hubspot-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-hubspot"
      ],
      "env": {
        "HUBSPOT_API_KEY": "<your-hubspot-api-key>"
      }
    }
  }
}

npm package: @modelcontextprotocol/server-hubspot

Tools exposed by HubSpot MCP Server

Once installed, HubSpot MCP Server exposes the following MCP tools to your AI assistant. Each tool can be called directly by the assistant whenever its capability is relevant to your prompt.

• hubspot_search_contacts

  Search for contacts in HubSpot using a query string.

• hubspot_get_contact

  Get a specific contact by ID.

• hubspot_create_contact

  Create a new contact in HubSpot.

• hubspot_update_contact

  Update an existing contact in HubSpot.

• hubspot_list_deals

  List deals in HubSpot with pagination.

• hubspot_get_deal

  Get a specific deal by ID.

• hubspot_create_deal

  Create a new deal in HubSpot.

• hubspot_update_deal

  Update an existing deal in HubSpot.

• hubspot_list_companies

  List companies in HubSpot with pagination.

• hubspot_get_company

  Get a specific company by ID.

• hubspot_get_sales_analytics

  Get aggregated sales analytics data for specific time periods.

• hubspot_get_deal_history

  Get the complete history of changes to a deal.

• hubspot_get_deal_notes

  Get notes associated with a specific deal.

• hubspot_get_engagements_by_deal

  Get all engagement activities associated with a deal.

• hubspot_get_sales_performance

  Get performance metrics for sales reps over a specific time period.

• hubspot_get_pipeline_analytics

  Get analytics for a specific sales pipeline including conversion rates between stages.

• hubspot_get_forecast_analytics

  Get forecasted sales data based on current pipeline and historical performance.

Required environment variables

HubSpot MCP Server needs the following environment variables set before it can run. Add them to the env block of your mcpServers entry, or export them in your shell before launching the client.

• HUBSPOT_API_KEY

Create a HubSpot Private App and set appropriate scopes.

Transport

HubSpot MCP Server supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

More automate.revenue_ops.personalization MCP servers

Other Model Context Protocol servers in the same space as HubSpot MCP Server. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

• apollo-mcp-server

  MCP server for Apollo.io — people search, contact management, sequences, and organization enrichment via the Model Context Protocol

• lgl-mcp-server

  MCP server for Little Green Light CRM. Search donors, log gifts, manage groups and contacts.

• mcp

  MCP server for SeldonFrame — AI-native Business OS platform. v1.2.0: complete the default personality + add CTA defense layers. The Ironclad Roofing demo exposed the gap that v1.1.9 didn't catch: roofing fell through to coaching personality, both CTAs wen

• media-mcp

  MCP Server for video enhancement and image segmentation (SAM3)

• Salesforce Marketing

  MCP server for Salesforce — 47 tools for leads, campaigns, pipeline, attribution, and reporting.

• LinkedIn Campaign Manager

  MCP server for LinkedIn Ads — 19 read-only tools for campaigns, performance, and Lead Gen Forms.

• mcp-1c

  MCP server for 1C:Enterprise — read+write CRM/ERP through Claude/Cursor/Cline.

• Provar MCP Server

  Provar MCP: AI-powered Salesforce test automation. Generate, validate, migrate, and run tests.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.