Skip to Content
MCP ServersSetup ExamplesHubSpot

HubSpot MCP Server

This guide walks through connecting the HubSpot MCP server to auxilia. HubSpot uses static OAuth credentials, so you need to register an OAuth app in HubSpot first.

1. Create a HubSpot OAuth app

  1. Go to the HubSpot Developer Portal 
  2. Apps → Create app
  3. Fill in the app details:
    • App name: auxilia MCP
    • Description: MCP integration for auxilia
  4. Open the Auth tab
  5. Set the Redirect URL to: 
    <FRONTEND_URL>/api/backend/mcp-servers/oauth/callback
    For example: 
    https://auxilia.example.com/api/backend/mcp-servers/oauth/callback
    For local development: 
    http://localhost:3000/api/backend/mcp-servers/oauth/callback
  6. Under Scopes, add the scopes required by the HubSpot MCP server (CRM scopes — typically crm.objects.contacts.read, crm.objects.deals.read, crm.objects.companies.read, and the matching write scopes if the agent needs to mutate data)
  7. Click Create app
  8. Copy the Client ID and Client Secret from the Auth tab

2. Install the HubSpot MCP server

In auxilia, navigate to MCP Servers:

  1. Find HubSpot in the official servers list
  2. Click Install
  3. Enter:
    • Client ID — from the HubSpot Auth tab
    • Client Secret — from the HubSpot Auth tab

3. Connect your account

  1. Click Connect on the HubSpot server card
  2. You’re redirected to HubSpot’s authorization page
  3. Select the HubSpot account to connect
  4. Grant the requested permissions
  5. You’re redirected back to auxilia

The server card now shows as connected.

4. Add to an agent

  1. Open an agent’s configuration page
  2. Click Add MCP Server and pick HubSpot
  3. Configure tool settings — for HubSpot, write tools are a good candidate for needs approval

Troubleshooting

”Invalid redirect URI”

Make sure the redirect URL in your HubSpot app matches <FRONTEND_URL>/api/backend/mcp-servers/oauth/callback exactly — no trailing slash, protocol, or subdomain mismatches.

”Token exchange failed”

Verify that:

  • Your HubSpot app has the scopes the MCP server requests
  • The client secret you entered in auxilia matches the one shown in HubSpot
  • The HubSpot app has been fully created (not still in draft)
AuthenticationGitHub