HubSpot MCP Server

Official HubSpot MCP server connecting AI tools to the HubSpot CRM. Enables agents to read and manage contacts, companies, deals, and tickets, search the CRM, and create engagements such as notes and tasks. Honors HubSpot scopes and rate limits via OAuth.

{
  "mcpServers": {
    "hubspot": {
      "command": "npx",
      "args": [
        "-y",
        "@hubspot/mcp-server"
      ],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "<YOUR_HUBSPOT_ACCESS_TOKEN>"
      }
    }
  }
}

{
  "type": "object",
  "required": [
    "object_type",
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search text"
    },
    "object_type": {
      "type": "string",
      "description": "CRM object type (contacts, companies, deals, tickets)"
    }
  }
}

{
  "type": "object",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Contact email address"
    },
    "lastname": {
      "type": "string",
      "description": "Last name"
    },
    "firstname": {
      "type": "string",
      "description": "First name"
    },
    "properties": {
      "type": "object",
      "description": "Additional contact properties"
    }
  }
}

{
  "type": "object",
  "required": [
    "deal_id"
  ],
  "properties": {
    "stage": {
      "type": "string",
      "description": "Pipeline stage to move the deal to"
    },
    "amount": {
      "type": "number",
      "description": "Deal amount"
    },
    "deal_id": {
      "type": "string",
      "description": "Deal record ID"
    }
  }
}