HubSpot MCP Server

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

1. Create a HubSpot OAuth App

Go to the HubSpot Developer Portal
Navigate to Apps → Create app
Fill in the app details:
- App name: auxilia MCP
- Description: MCP integration for auxilia
Go to the Auth tab

Set the Redirect URL to:


https://your-auxilia-domain.com/mcp-servers/oauth/callback

For local development:


http://localhost:8000/mcp-servers/oauth/callback

Under Scopes, add the scopes required by the HubSpot MCP server (typically CRM scopes like crm.objects.contacts.read, crm.objects.deals.read, etc.)
Click Create app
Copy the Client ID and Client Secret from the Auth tab

2. Install the HubSpot MCP Server

In auxilia, navigate to MCP Servers:

Find HubSpot in the official servers list
Click Install
Enter the credentials from your HubSpot OAuth app:
- Client ID: Your HubSpot app’s client ID
- Client Secret: Your HubSpot app’s client secret

3. Connect Your Account

Click the Connect button on the HubSpot server card
You’ll be redirected to HubSpot’s authorization page
Select the HubSpot account to connect
Grant the requested permissions
You’ll be redirected back to auxilia

The server card should now show a connected status.

4. Add to an Agent

Navigate to an agent’s configuration page
Click Add MCP Server
Select HubSpot from the list
Configure tool settings for each HubSpot tool

Available Tools

The HubSpot MCP server typically provides tools for:

Searching and managing contacts
Managing deals and pipelines
Working with companies
Querying HubSpot CRM data

Troubleshooting

”Invalid redirect URI” error

Make sure the redirect URL in your HubSpot app exactly matches your auxilia deployment URL, including the path /mcp-servers/oauth/callback.

”Token exchange failed” error

Verify that:

Your HubSpot app has the required scopes enabled