Set up HubSpot MCP in Windsurf
CRM data access, contact management, deal tracking, and company information from HubSpot. Official integration in public beta.
1
Locate the config file
Windsurf reads MCP server configuration from the following file:
~/.codeium/windsurf/mcp_config.jsonCreate this file if it does not already exist.
2
Add the configuration
Add the following to your Windsurf config file:
json
{
"mcpServers": {
"hubspot-mcp": {
"command": "npx",
"args": [
"-y",
"@hubspot/mcp-server"
],
"env": {
"HUBSPOT_ACCESS_TOKEN": "YOUR_HUBSPOT_ACCESS_TOKEN"
}
}
}
}3
Set up environment variables
HubSpot MCP requires the following environment variables:
HUBSPOT_ACCESS_TOKENRequiredHubSpot private app access token
4
Verify it works
Restart Windsurf. HubSpot MCP should appear in your MCP server list with 10 tools available.
This server adds approximately 5,150 tokens to your context window for tool definitions.