HubSpot MCP Server

Welcome to the HubSpot MCP Server! This guide will get you up and running in just a few minutes.

- Python 3.8+installed on your system
- Claude Desktopapplication installed
- HubSpot Developer Account(free)
- Nango Integrationconfigured (for secure authentication)

- NANGO_BASE_URL: Your Nango instance base URL
- NANGO_SECRET_KEY: Your Nango secret key
- NANGO_CONNECTION_ID: Your connection identifier
- NANGO_INTEGRATION_ID: Your integration identifier

Add this configurationto your Claude Desktop config file:

Location:~/Library/Application Support/Claude/claude_desktop_config.json

Location:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "hubspot": { "command": "uvx", "args": ["git+https://github.com/Shameerpc5029/hubspot-mcp.git"], "env": { "NANGO_BASE_URL": "enter_your_nango_base_url_here", "NANGO_SECRET_KEY": "enter_your_nango_secret_key_here", "NANGO_CONNECTION_ID": "enter_your_nango_connection_id_here", "NANGO_INTEGRATION_ID": "enter_your_nango_integration_id_here" } } } }

Important: Replace the placeholder values with your actual Nango credentials:

- Replaceenter_your_nango_base_url_herewith your Nango base URL
- Replaceenter_your_nango_secret_key_herewith your secret key
- Replaceenter_your_nango_connection_id_herewith your connection ID
- Replaceenter_your_nango_integration_id_herewith your integration ID

Close and reopen Claude Desktop to load the new configuration.
- Test connection:"List all companies in my HubSpot"
- Create a test company:"Create a company called Test Corp with domain test.com"
- Search for contacts:"Find all contacts with gmail email addresses"

- Create, update, delete companies
- Search by domain or other criteria
- Get recent company activity
- Bulk operations with filters

- Create, update, delete contacts
- Search by email, name, phone
- Manage list memberships
- Track recent contact activity

- "Create a company for Acme Corp with their website acme.com"
- "Find the contactjohn@example.comand update their phone number"
- "Show me all companies created this month"
- "Add contact ID 12345 to my VIP customers list"

"Can you connect to my HubSpot account?" "Show me my recent contacts" "List my companies"

- Documentation: See the mainREADME.mdfor detailed info
- Issues: Report problems onGitHub Issues
- HubSpot API: CheckHubSpot Developer Docs

Control Reply.io sequences and contacts directly from your AI model. Manage outreach, pull stats, and enroll prospects — without leaving your AI chat.