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:

  1. Cursor will show: Authorization prompt for HubSpot
  2. Click Authorize: You’ll be redirected to HubSpot
  3. Select Account: Choose your HubSpot account
  4. Grant Permissions: Allow the app to access your CRM data
  5. 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.js

Configuration 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.json has 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 config
  • MCP_CURSOR_SETUP.md - Detailed setup documentation
  • QUICK_START_CURSOR.md - This file

Ready to Use!

After restarting Cursor, try:

"Show me all deals for Inteleos"