Quick Start: HubSpot MCP in Cursor
✅ Configuration Complete
HubSpot MCP has been added to your Cursor configuration at ~/.cursor/mcp.json.
Next Steps
1. Restart Cursor
Important: Restart Cursor completely for the MCP configuration to load.
2. Authorize HubSpot (First Time Only)
When you first use HubSpot MCP, Cursor will prompt you to authorize:
- Cursor will show: Authorization prompt for HubSpot
- Click Authorize: You’ll be redirected to HubSpot
- Select Account: Choose your HubSpot account
- Grant Permissions: Allow the app to access your CRM data
- Complete: You’ll be redirected back to
https://www.brainforge.ai
3. Start Using HubSpot MCP
Once authorized, you can use natural language queries in Cursor:
Test Queries
For Inteleos:
- “Show me all deals for Inteleos”
- “Get contact details for Juan Sanchez”
- “What company is Inteleos?”
- “Who are the contacts on deals for Inteleos?”
General Queries:
- “Show me all deals”
- “What deals are in the ‘Qualified To Buy’ stage?”
- “List all companies”
- “Get contact details for [name]“
What You Can Do
✅ Read Operations (via MCP)
- Query deals, contacts, companies
- Search CRM objects
- Get object details and properties
- Traverse associations
✅ Write Operations (via API Service)
For creating/updating deals, use the API service:
cd integrations/hubspot/api-service
npx tsx test-inteleos-details.jsConfiguration Details
- MCP Server:
https://mcp.hubspot.com/ - Auth Type: OAuth 2.0 with PKCE
- Client ID:
e151e63f-399c-4c64-b1b2-7616966f79f9 - Redirect URI:
https://www.brainforge.ai
Troubleshooting
”MCP server not found”
- Restart Cursor completely
- Check
~/.cursor/mcp.jsonhas the hubspot entry
”Authorization failed”
- Verify redirect URI matches:
https://www.brainforge.ai - Check Client ID and Secret are correct
- Ensure HubSpot MCP auth app is active
”No data returned”
- Complete the OAuth authorization flow
- Check your HubSpot account permissions
- Verify the MCP server is connected (check Cursor status)
Files Created
~/.cursor/mcp.json- Updated with HubSpot MCP configMCP_CURSOR_SETUP.md- Detailed setup documentationQUICK_START_CURSOR.md- This file
Ready to Use!
After restarting Cursor, try:
"Show me all deals for Inteleos"