Hubspot MCP

🚀 Integrating Claude Desktop with HubSpot

This guide provides a step - by - step process to integrate Claude Desktop with HubSpot, including creating a private app, setting up permissions, and using the integration.

🚀 Quick Start

Create a HubSpot Private App

1. Log in to your HubSpot account.
2. Navigate to Settings → Account Settings → Integrations → Private Apps.
3. Click “Create a private app”.
4. Name your app and select the appropriate scopes (including contacts, deals, and companies).
5. After creation, copy your private app token.

Required Scopes

• crm.objects.contacts.read
• crm.objects.contacts.write
• crm.objects.deals.read
• crm.objects.deals.write
• crm.objects.companies.read
• crm.objects.companies.write
• crm.objects.owners.read
• crm.objects.quotes.read
• crm.objects.line_items.read
• crm.objects.custom.read
• crm.schemas.deals.read
• crm.schemas.contacts.read
• crm.schemas.companies.read
• crm.schemas.custom.read

Use with Claude Desktop

Add the following content to your claude_desktop_config.json file:

Using npx Command

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

Using Docker Command

{
  "mcpServers": {
    "hubspot": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "HUBSPOT_API_KEY", "mcp/hubspot"],
      "env": {
        "HUBSPOT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Troubleshooting

If you encounter issues, check the following:

1. Ensure that all required scopes have been added to your HubSpot private app.
2. Confirm that the API key has been correctly copied into the configuration file.
3. Confirm that your HubSpot plan includes the API permissions you are trying to use.

Build

Build the Docker image using the following command:

docker build -t mcp/hubspot -f Dockerfile .

📄 License

This MCP server is released under the MIT License. This means you are free to use, modify, and distribute the software, provided you comply with the terms and conditions of the MIT License. For more details, refer to the LICENSE file in the project repository.