HubSpot MCP Server
The HubSpot MCP server lets your AI agents interact with your HubSpot CRM. Agents can retrieve, list, and search contacts, companies, and deals, look up record owners, and explore deal pipelines and stages — all read-only and scoped to the authenticated user's permissions.
Capabilities
| Tool | What It Does |
|---|---|
| Get contact | Retrieve a single contact by record ID |
| List contacts | List contacts with pagination and property selection |
| Search contacts | Search contacts using filters, free-text queries, and sorting |
| Get company | Retrieve a single company by record ID |
| List companies | List companies with pagination and property selection |
| Search companies | Search companies using filters, free-text queries, and sorting |
| Get deal | Retrieve a single deal by record ID |
| List deals | List deals with pagination and property selection |
| Search deals | Search deals using filters, free-text queries, and sorting |
| List owners | List HubSpot owners (users who can be assigned to records) |
| List deal pipelines | List all deal pipelines with their stages |
| Get deal pipeline | Retrieve a specific deal pipeline and its stages |
📝 Note: All HubSpot tools are read-only. The agent cannot create, update, or delete CRM records.
OAuth Setup
The HubSpot MCP server uses OAuth to authenticate on behalf of each user. To enable this integration, you need to create a HubSpot app and provide the credentials to Devs.ai.
Step 1: Create a HubSpot App
- Go to the HubSpot Developer Portal and sign in.
- Navigate to Apps and click Create app.
- Enter a name (for example, "Devs AI") and optionally add a description and logo.
Step 2: Configure OAuth
- In your app settings, go to the Auth tab.
- Copy the Client ID and Client Secret.
- Under Redirect URLs, add the redirect URL provided by your Devs.ai platform administrator.
- Under Scopes, add the following:
| Scope | What It Enables |
|---|---|
crm.objects.contacts.read | Read contact records |
crm.objects.companies.read | Read company records |
crm.objects.deals.read | Read deal records |
crm.objects.owners.read | Read owner (user) information |
- Click Save.
Step 3: Configure in Devs.ai
- Navigate to Organization > Connectors in Devs.ai.
- Find the HubSpot template and click Enable.
- Select OAuth as the authentication type.
- Enter your Client ID and Client Secret from Step 2.
- Select the tools you want to make available.
- Click Save.
When a user first interacts with an agent connected to HubSpot, they will be prompted to authorize access to their HubSpot account.
OAuth Configuration Reference
| Field | Value |
|---|---|
| Authorization URL | https://app.hubspot.com/oauth/authorize |
| Token URL | https://api.hubapi.com/oauth/v1/token |
| Scopes | crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read |