HubSpot MCP Server — Hosted for Any AI Agent
MCP Server shield Key RequiredContacts, deals, companies, tickets, workflows via HubSpot's official MCP
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"hubspot-crm": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-hubspot",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the get_contact tool to retrieve a hubspot contact by id with all crm properties and association data”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
The HubSpot MCP server connects AI agents to your HubSpot CRM — managing contacts, companies, deals, and tickets. Hosted on Aerostack with one URL for any MCP client, it lets an agent update records, pull pipeline data, and automate marketing and sales workflows from chat.
description Overview
HubSpot CRM MCP
Official proxy MCP — Contacts, deals, companies, tickets, workflows via HubSpot's official MCP
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-hubspot
Overview
HubSpot CRM is a proxy MCP server that forwards requests directly to the official HubSpot MCP endpoint at https://mcp.hubspot.com. All tools are maintained by HubSpot — new tools are available immediately without any Aerostack update.
Type: Proxy (hosted by HubSpot)
Auth: Bearer token via HUBSPOT_ACCESS_TOKEN
Available Tools
- get_contact — Retrieve a HubSpot contact by ID with all CRM properties and association data
- create_contact — Create a new HubSpot contact with email, name, phone, and any custom CRM properties
- list_deals — List CRM deals in HubSpot with optional filtering by pipeline, stage, or owner
- update_deal — Update properties of an existing HubSpot deal such as amount, stage, or close date
- search_contacts — Search HubSpot contacts using filter criteria on any CRM property with sorting support
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
HUBSPOT_ACCESS_TOKEN |
Yes | HubSpot Private App Access Token | app.hubspot.com → Settings → Integrations → Private Apps → Create private app |
Setup
Add to Aerostack Workspace
- Go to app.aerostack.dev/workspaces → Create Workspace
- Inside your workspace → Add Server → search "HubSpot CRM"
- Enter your
HUBSPOT_ACCESS_TOKENwhen prompted — stored encrypted, injected automatically
Once added, every AI agent in your workspace can use HubSpot tools automatically.
Usage
Example Prompts
"List all my HubSpot items and summarize the most recent ones"
"Find anything related to [keyword] in HubSpot"
"Create a new entry with the following details: ..."
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-hubspot \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-HUBSPOT-ACCESS-TOKEN: your-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_contact","arguments":{}}}'
License
MIT
terminal Tools (5)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
get_contact #1 Retrieve a HubSpot contact by ID with all CRM properties and association data
create_contact #2 Create a new HubSpot contact with email, name, phone, and any custom CRM properties
list_deals #3 List CRM deals in HubSpot with optional filtering by pipeline, stage, or owner
update_deal #4 Update properties of an existing HubSpot deal such as amount, stage, or close date
search_contacts #5 Search HubSpot contacts using filter criteria on any CRM property with sorting support
Details
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in Devops
Browse Devops MCPs →Asana Project Management
by @aerostack
Tasks, projects, sections, comments, teams, custom fields via Asana's official MCP
Atlassian Cloud
by @aerostack
Jira issues, sprints, Confluence pages via Atlassian's official MCP
Cloudflare Platform
by @aerostack
Cloudflare Workers, KV, R2, D1, Pages, DNS via Cloudflare's official MCP
Datadog Observability
by @aerostack
Dashboards, monitors, logs, metrics, incidents, SLOs, APM traces via Datadog's official MCP
Figma Design
by @aerostack
Files, frames, components, comments, variables via Figma's official MCP
GitHub API
by @aerostack
GitHub repos, PRs, issues, branches, code search via GitHub's official hosted MCP
Frequently asked questions
What is the HubSpot MCP server and what can it do? +
The HubSpot MCP server is hosted on Aerostack and exposes these tools to your AI agent: `get_contact`, `create_contact`, `list_deals`, `update_deal`, `search_contacts`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the HubSpot MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the HubSpot MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same HubSpot MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the HubSpot MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-hubspot": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-hubspot"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the HubSpot MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-hubspot", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-hubspot"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does HubSpot MCP require authentication? +
Yes. HubSpot uses Bearer token authentication. Set your token as a workspace secret in the Aerostack dashboard.