Customer Relation

HubSpot MCP Server

Connect your account, then chat with AI to run tools.

HubSpot is a full-featured CRM platform that helps businesses manage customer relationships, marketing automation, sales pipelines, and customer service. Use it to manage contacts, companies, deals, tickets, marketing campaigns, content, and more.

72 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for HubSpot — workflow patterns, data models, and gotchas for your AI agent.

HubSpot

Routing (use this order)

  1. CRM objects (contacts, companies, deals, tickets, engagements, commerce objects, lists, pipelines): use the consolidated CRM read tool with object_type; add record_id for one row or use list pagination fields. Use the consolidated CRM upsert tool with object_type and properties; include the record id only when updating. List before you write when ids are unknown.
  2. CMS (pages, posts, domains, HubDB, redirects, authors, tags, blog settings): use the consolidated CMS read and consolidated CMS upsert tools with object_type — discover with read, then change with upsert.
  3. Marketing assets (forms, campaigns, marketing emails, marketing events, SMTP metadata): use the consolidated Marketing read and consolidated Marketing upsert tools with object_type. Form submission and one-off sends use the dedicated submit/send tools in the tool list, not the asset list tools.
  4. Delete: use the delete tool with hubspot:{objectType}:{numericId}.

Reach for specialized tools (imports/exports, schemas, owners, timeline, workflows, files, webhooks, meetings booking, etc.) when the task is explicitly about those surfaces — not for routine CRM/CMS/marketing object work.

Data model

  • Contacts — people; Companies — accounts; Deals — opportunities (need pipeline + stage); Tickets — support.
  • Engagements — emails, calls, meetings, notes, tasks where exposed as CRM types.
  • Commerce — products, quotes, invoices, orders, line items, carts as separate types.
  • Lists and pipelines — first-class; stages come from pipeline metadata.
  • Associations — directional; wrong direction breaks or links incorrectly.

Properties

  • Fields use internal API names (firstname, hs_object_id, …), not UI labels. If a write or filter fails, read schema or list a row and reuse exact keys from the response.

OAuth

  • Permission sets (connect UI): pick the smallest set that covers the work — CRM only (no CMS/marketing APIs), CRM + CMS (content), CRM + Marketing (forms + email-related scopes), or Full (all scopes in this bundle). The HubSpot developer app must also have those scopes enabled, or HubSpot will not put them on the token even when requested.
  • 403 with missing granular scopes means the HubSpot app for this connection lacks scope for that API (for example CMS content or marketing forms) — expand app scopes and reconnect; it is not fixed by retrying with different parameters on the same token. The **content` scope is tied to CMS Hub / Marketing Hub tiers in HubSpot’s product rules.
  • Owners list (crm.objects.owners.read): some portals return “user level OAuth token is not allowed” for non-admin users; use owner ids from CRM record properties (hubspot_owner_id) when listing owners fails.
  • Some admin or legacy endpoints reject user-level tokens; prefer the consolidated read/upsert path for standard objects when you see “token not allowed for that endpoint.”

Portal metadata

  • Account details (portal id, timezone, currency, data region) come from the account-information API — use that tool when the user asks “which HubSpot account / portal is this?” instead of guessing from CRM rows.
  • Connection metadata: hub id, granted scopes, and expiry are exposed for the current OAuth connection — use the connection-validation tool when debugging which portal or scopes the bundle is bound to.

Record ids

  • Delete and cross-object references: hubspot:{objectType}:{id}.
  • Single-row CRM read (where supported): object_type + record_id as the numeric id string.

Habits that work well

  • One object family per step: read → decide → write or delete.
  • Do not invent property names — take them from prior reads or schema output.
  • For new deals, set pipeline and stage from pipeline metadata, not from memory.

Tools in this Server (72)

Delete

Universal delete tool that removes ANY HubSpot resource using smart ID routing with colon-separated format. Supports CRM objects (contacts, companies,...

Hubspot Book Meeting

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Cms Read

Read HubSpot CMS data for one resource family at a time (pages, posts, domains, HubDB tables, redirects, authors, tags, site search stub, blog setting...

Hubspot Cms Upsert

Create or update HubSpot CMS resources (pages, posts, domains, authors, tags, HubDB table/row, URL redirects, blog settings). Pass `properties` using ...

Hubspot Create Call

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Create Conversation

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Create Export

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Create Import

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Create Meeting

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Create Note

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Create Task

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Create Timeline Event

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Crm Read

Read HubSpot CRM data for a core object type. Pass `record_id` to load one record by id for standard CRM objects (contacts, companies, deals, etc.). O...

Hubspot Crm Upsert

Create or update a HubSpot CRM record for a core object type. Pass `record_id` to patch an existing row; omit it to create. Set `properties` using int...

Hubspot Delete Webhook

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Enroll Contact

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Account Info

Returns HubSpot **portal / account** metadata via `GET /account-info/2025-09/details` (portal id / Hub ID, account type, time zone, currencies, data h...

Hubspot Get Audit Log

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Availability

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Business Unit

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Conversation

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Currency

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Custom Action

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Event

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Export

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Get Import

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Get Origins

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Property

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Get Schema

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Get User

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Get Visitor

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Webhook

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Get Workflow

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Identify Visitor

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot List Audit Logs

Lists account audit log entries via `GET /account-info/v3/activity/audit-logs` with pagination. Returns security-relevant activity (logins, settings c...

Hubspot List Business Units

Lists business units visible to the authenticated user via `GET /business-units/v3/business-units/user/{user_id}`. Resolves the current user from the ...

Hubspot List Channels

Lists custom conversation channels via `GET /conversations/v3/custom-channels/`. Returns channel definitions for the Conversations inbox integrations....

Hubspot List Conversations

Lists conversation channels (inbox routing metadata) via `GET /conversations/v3/conversations/channels`. Returns JSON for service inbox configuration ...

Hubspot List Currencies

Lists supported currency codes via `GET /settings/v3/currencies/codes`. Returns ISO codes HubSpot accepts for deals and commerce fields. Use before se...

Hubspot List Custom Actions

Lists workflow custom actions for a HubSpot app via `GET /automation/v4/actions/{app_id}`. Requires the HubSpot app ID associated with your integratio...

Hubspot List Event Definitions

Lists behavioral event definitions via `GET /events/v3/event-definitions`. Returns schema for custom analytics events you can emit from sites or apps....

Hubspot List Events

Lists captured behavioral events via `GET /events/v3/events/` with pagination. Returns occurrences emitted against your event definitions. Use for ana...

Hubspot List Files

Queries HubSpot file manager assets via `GET /files/v3/files/search` with limit and paging parameters. Returns file metadata and IDs for attachments, ...

Hubspot List Folders

Queries HubSpot file manager folders via `GET /files/v3/folders/search` with limit and paging parameters. Returns folder metadata for organizing asset...

Hubspot List Owners

Lists HubSpot CRM owners via `GET /crm/v3/owners/` with optional pagination and email filter. Returns owner IDs, emails, and team metadata for assignm...

Hubspot List Properties

Lists property definitions for a CRM object type via `GET /crm/v3/properties/{object_type}`. Pass `object_type` such as contacts, companies, deals, or...

Hubspot List Schemas

Lists HubSpot CRM object schemas via `GET /crm/v3/schemas` with pagination. Returns definitions for standard and custom objects, including property me...

Hubspot List Sequences

Lists automation flows (sequences and workflow-style automations) via `GET /automation/v4/flows` with pagination. Returns flow metadata for sales enga...

Hubspot List Single Sends

Attempts to list marketing single-send batches, but HubSpot does not expose a compatible list endpoint here — the handler raises `ToolError` explainin...

Hubspot List Subscription Preferences

Lists communication subscription type definitions via `GET /communication-preferences/v3/definitions`. Returns the subscription categories contacts ca...

Hubspot List Tax Rates

Lists currency exchange rates / tax-related settings via `GET /settings/v3/currencies/exchange-rates`. Returns data for multi-currency conversion in c...

Hubspot List Timeline Events

Lists CRM timeline events via `GET /crm/v3/timeline/events` with pagination. Returns event payloads attached to CRM record timelines. Use to audit act...

Hubspot List Users

Legacy alias for listing CRM owners — calls `GET /crm/v3/owners/` with `limit` and optional `after` cursor. Prefer `hubspot_list_owners` (same API, cl...

Hubspot List Webhooks

Lists webhook subscriptions registered for a HubSpot app via `GET /webhooks/v3/{app_id}/subscriptions`. Requires your HubSpot app ID. Use to audit whi...

Hubspot List Workflows

Lists automation flows (workflows) via `GET /automation/v4/flows` — same automation surface as `hubspot_list_sequences`. Returns workflow metadata for...

Hubspot Marketing Read

Read HubSpot Marketing data for one family at a time: forms, campaigns, marketing email assets, marketing events, or SMTP token metadata. Uses paginat...

Hubspot Marketing Upsert

Create or update HubSpot Marketing definitions: campaign, form, marketing email asset, or marketing event. Pass `properties` using internal Marketing ...

Hubspot Send Event Completion

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Send Single Email

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For campaigns, forms, or...

Hubspot Send Transactional Email

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For campaigns, forms, or...

Hubspot Submit Form

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For campaigns, forms, or...

Hubspot Upload File

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Upsert Channel

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Upsert Event Definition

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Upsert Folder

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Upsert Property

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Upsert Sequence

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Upsert Subscription Preference

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Upsert Tax Rate

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Upsert User

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For CRM owners, schemas,...

Hubspot Upsert Webhook

Issues `GET /crm/v3/objects` and returns the JSON body under `resource` (read-only). Use when you need that HubSpot response. For audit logs, files, w...

Hubspot Validate Token

Returns metadata for the current OAuth access token via `GET /oauth/v1/access-tokens/{token}` (user id, hub id, scopes, expiration). Use to confirm wh...

Frequently Asked Questions

What is the HubSpot MCP server?

HubSpot is a full-featured CRM platform that helps businesses manage customer relationships, marketing automation, sales pipelines, and customer service. Use it to manage contacts, companies, deals, tickets, marketing campaigns, content, and more. It provides 72 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect HubSpot to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/hubspot. Authentication is handled automatically.

How many tools does HubSpot provide?

HubSpot provides 72 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does HubSpot require?

HubSpot uses One-click sign in. HubSpot requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect HubSpot to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/hubspot

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Related MCP Servers

More customer relation integrations you might like

Affinity

Affinity is a relationship intelligence CRM platform designed for deal flow and relationship managem...

32 tools
Customer Relation
AgileCRM

AgileCRM is a customer relationship management platform that helps businesses manage sales, marketin...

11 tools
Customer Relation
Aircall

Aircall is a cloud-based call center and phone system that integrates with various CRM and Helpdesk ...

9 tools
Customer Relation
Apptivo

Apptivo is a cloud-based suite of CRM applications designed to manage sales, marketing, and support ...

5 tools
Customer Relation
Attio Activity

Attio communication and activity data — email threads, call recordings with transcripts, and meeting...

8 tools
Customer Relation
Attio Admin

Attio workspace administration — manage objects, attributes, select options, statuses, list schemas,...

24 tools
Customer Relation

Ready to use HubSpot?

Sign in to connect your credentials and start running tools from the chat.

HubSpot MCP Server & Skill — 72 Tools