Brainforge Knowledge

MCP_CURSOR_SETUP

2 min read

HubSpot MCP Setup in Cursor

Date: January 31, 2026
Status: ✅ Configured

Configuration Added

The HubSpot MCP server has been added to your Cursor MCP configuration at ~/.cursor/mcp.json.

Configuration Details

{
  "mcpServers": {
    "hubspot": {
      "url": "https://mcp.hubspot.com/",
      "type": "http",
      "auth": {
        "type": "oauth",
        "clientId": "e151e63f-399c-4c64-b1b2-7616966f79f9",
        "clientSecret": "7dd6e6e2-7e91-4ba2-8123-7ca4e655bf06",
        "redirectUri": "https://www.brainforge.ai"
      }
    }
  }
}

Credentials Source

  • 1Password Item: Hubspot MCP (Personal vault)
  • Client ID: e151e63f-399c-4c64-b1b2-7616966f79f9
  • Client Secret: 7dd6e6e2-7e91-4ba2-8123-7ca4e655bf06
  • Redirect URI: https://www.brainforge.ai
  • App ID: 30068983

Next Steps

1. Restart Cursor

After adding the MCP configuration, restart Cursor to load the new MCP server.

2. Complete OAuth Flow

When you first use the HubSpot MCP in Cursor, you’ll need to complete the OAuth flow:

  1. Cursor will prompt you to authorize the HubSpot MCP app
  2. You’ll be redirected to HubSpot to select your account
  3. Grant permissions to the app
  4. Authorize the connection
  5. You’ll be redirected back to https://www.brainforge.ai

3. Test the Connection

Once authorized, test with natural language queries in Cursor:

Read Operations:

  • “Show me all deals for Inteleos”
  • “What’s the status of deal X?”
  • “Get contact details for Juan Sanchez”
  • “List all companies”
  • “Who are the contacts on the Inteleos deal?”

Query Examples:

  • “Show me all deals”
  • “What deals are in the ‘Qualified To Buy’ stage?”
  • “Get contact details for Juan Sanchez”
  • “List all companies”

Troubleshooting

OAuth Flow Issues

If the OAuth flow doesn’t start:

  1. Check that the redirect URI matches exactly: https://www.brainforge.ai
  2. Verify the Client ID and Client Secret are correct
  3. Ensure the HubSpot MCP auth app is active in HubSpot

Connection Issues

If you see connection errors:

  1. Restart Cursor completely
  2. Check Cursor logs: ~/Library/Application Support/Cursor/logs/
  3. Verify the MCP server URL: https://mcp.hubspot.com/

Permission Issues

If queries return permission errors:

  1. Check your HubSpot user permissions
  2. Verify the MCP auth app has the necessary scopes
  3. Re-authorize the connection if needed

MCP Server Capabilities

The HubSpot MCP server provides read-only access to:

  • ✅ Deals
  • ✅ Contacts
  • ✅ Companies
  • ✅ Tickets
  • ✅ Products
  • ✅ Orders
  • ✅ Line Items
  • ✅ Invoices
  • ✅ Quotes
  • ✅ Subscriptions

Note: For write operations (create/update deals, etc.), use the HubSpot API service (api-service/).

Configuration File Location

  • Path: ~/.cursor/mcp.json
  • Backup: Consider backing up this file before making changes

Graph View

Backlinks