Skip to content
HubSpot

HubSpot MCP connector

HubSpot MCP OAuth · Available

HubSpot MCP Connector for AI Agents

Connect Claude, ChatGPT and other AI agents to HubSpot over MCP: search contacts, companies and deals, and create or update records in one HubSpot portal.

Connect HubSpot once in ApexGenius through HubSpot’s official hosted MCP, then search and read contacts, companies, deals, tickets, conversations and campaign analytics from compatible AI agents, and create or update CRM records. Each AI agent needs its own ApexGenius setup.

Connect HubSpot Setup guide

1,000 free credits · No card required

HubSpot

HubSpot

App connector

Available

Bring your HubSpot connection to compatible AI agents. Search contacts, companies and deals, then create or update CRM records.

29
Operations
18
Read
11
Write
3
In context
Authorization
HubSpot MCP OAuth
Cataloged tools
29 discoverable
Connection scope
The HubSpot portal you choose on HubSpot’s sign-in page
Accounts
Connected account

Reviewed Oct 26, 2026

ClaudeChatGPT

Claude / ChatGPT

MCP client

ApexGenius route

Gateway context

HubSpot

HubSpot

Authorized session

Why the gateway is here

It keeps the HubSpot authorization, tools, and activity behind the same managed route you use for your other supported systems.

Ask it

What people ask HubSpot.

These questions use the HubSpot tools below. Start with a read after connecting your channel or account.

  • Which HubSpot account is connected, and which objects can I read and write? Do not change anything.Read
  • Which deals are open this month, with their stage, amount and owner?Read
  • Find the contact with the email I give you and show their company and recent activity.Read
  • Create a deal for the company I name with the amount and close date I give you. Show me the record first.Write

Tools

What HubSpot can do through ApexGenius.

The reviewed catalog contains these 29 HubSpot tools. Search by tool name, job, or access type.

Open the generated tool reference

Account and schema

get_user_details
Read

Read the connected user, account and object access. Start here.

Account and schema

get_organization_details
Read

Read teams, job titles, seat counts and account settings.

Account and schema

discover_hubspot_schema
Read

Find object types and whether each can be read or written.

Account and schema

tool_guidance
Read

Read HubSpot’s usage notes for one or more tools.

CRM records

search_crm_objects
Read

Search and filter CRM records, up to 200 a page.

CRM records

get_crm_objects
Read

Read up to 100 CRM records by id.

CRM records

query_crm_data
Read

Query CRM data with HubSpot’s SQL. No joins or subqueries.

CRM records

search_owners
Read

Find record owners by name, email or id.

CRM records

manage_crm_objects
Write

Create or update CRM records and activities.

Properties, pipelines and segments

search_properties
Read

Find property definitions by keyword.

Properties, pipelines and segments

get_properties
Read

Read full property definitions, with types and options.

Properties, pipelines and segments

manage_custom_properties
Write

Create custom properties on CRM objects.

Properties, pipelines and segments

manage_custom_pipelines
Write

Create and change pipelines.

Properties, pipelines and segments

manage_segment
Write

Create segments, and add or remove records in static segments.

Conversations and intent

search_conversations
Read

Search conversations and messages in the inboxes you can see.

Conversations and intent

get_conversation_channel_metadata
Read

List inboxes, channels and channel instances.

Conversations and intent

search_intent_signals
Read

Search buyer intent signals, grouped by company.

Campaigns and marketing email

read_campaign_data
Read

Read campaign analytics, asset metrics and contacts.

Campaigns and marketing email

get_campaign_attribution_reports
Read

Read closed-won revenue and deal attribution by campaign.

Campaigns and marketing email

get_marketing_email_analytics
Read

Read marketing email results for a date range.

Campaigns and marketing email

manage_campaign_objects
Write

Create or update campaigns and their assets.

Campaigns and marketing email

manage_marketing_email
Write

Manage marketing email templates, drafts, previews and A/B variants.

Content and AI search

get_content_analytics_report
Read

Read analytics for landing pages, website pages and blog posts.

Content and AI search

get_aeo_metrics
Read

Read brand-level AI search metrics.

Content and AI search

manage_aeo_prompts
Write

Read tracked AI search prompts and their answers, and add new ones.

Content and AI search

manage_aeo_recommendations
Write

Review AI search recommendations and start one.

Content and AI search

manage_landing_page
Write

Create, edit, clone and publish landing pages. Publishing makes a page public.

Onboarding and feedback

manage_onboarding
Write

Check CRM onboarding status and work through its steps.

Onboarding and feedback

submit_feedback
Write

Send feedback about the MCP server to HubSpot.

Connection model

How to connect HubSpot.

The HubSpot connection belongs to your signed-in account. Any HubSpot-native resources stay inside that provider.

Read connection details

Before you start

  • An account with permission to use the HubSpot resources you intend to connect.

1. Connect HubSpot to ApexGenius

  1. Open HubSpot in Connections. Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
    The HubSpot page in ApexGenius before you connect, with the Connect button in the header and the Not connected empty state.
    Open HubSpot in Connections and choose Connect. HubSpot then opens its own sign-in.Open full-size image (opens in a new tab)
  2. Choose the account and review access. Choose Continue to HubSpot. On HubSpot’s own page, sign in to the intended account, choose the portal, and review the requested access before returning to ApexGenius.
    HubSpot’s official page for connecting an ApexGenius account, with Sign in to your HubSpot account.
    HubSpot opens its own sign-in screen. Sign in to the account with access to your intended portal.Open full-size image (opens in a new tab)
  3. Review the connected account and resources. Check the saved portal and account identity. If you have more than one HubSpot connection, choose the intended account before reviewing its Tools tab.
  4. Check the connection. Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
Connect HubSpot →

2. Choose your AI and finish setup

Each guide includes the AI setup and a first question for HubSpot.

ChatGPT setup →Claude setup →Codex setup →

Current governance

Know the account, tools, and result.

ApexGenius keeps the selected context and current tool surface visible, then records supported write activity for review.

Authorized context

One connection covers one HubSpot portal and what your HubSpot user can see.

Current tool surface

HubSpot decides which tools the portal gets, from its subscription and your user permissions. get_user_details shows yours.

Reviewable activity

Calls go only to mcp.hubspot.com. ApexGenius keeps the grant encrypted and refreshes it.

Enabled writes run immediately. Turn a tool off to block calls.

Why a gateway

29 operations. Three tool definitions.

Your AI starts with three ApexGenius gateway tools. It discovers the HubSpot operations available to its authorization when a task needs them, then runs the selected operation through the gateway.

One saved provider connection

Connect HubSpot to ApexGenius, then authorize each AI client to use the saved connection with its own tool permissions.

Scoped per agent

Give one client read-only and the write operations never appear in its tool list at all.

Every call on the record

Which agent asked, what ran, and whether it succeeded, kept per connection for review.

Use HubSpot with your AI.

Choose your AI client for setup steps and examples using HubSpot.

FAQ

Questions people ask before connecting HubSpot.

How do I connect HubSpot?
Choose Connect on the HubSpot connection in ApexGenius. On HubSpot’s own page, sign in, choose the portal, and allow access. There is no API key to paste.
Does this use the official HubSpot MCP server?
Yes. ApexGenius connects to HubSpot’s hosted MCP at mcp.hubspot.com and passes its tools to your AI agents through one governed connection.
Can my AI change HubSpot records?
Yes, when the write tool is on. It can create and update contacts, companies, deals, tickets and activities. HubSpot’s MCP does not delete records. Turn a tool off to block calls.
Why can’t I see every tool?
HubSpot decides which tools a portal gets from its subscription and your user permissions. AI search tools need Marketing Hub Professional or Enterprise. Ask your AI to run get_user_details to see your access.
Can I start with read-only access?
Yes. Choose Read only when you add your AI agent. Searches and reads still work, and every write is refused.

MCP-compatible AI agents

ClaudeChatGPTCursorVS Code

Codex starts in Plugins in the ChatGPT desktop app. ChatGPT Chat and Work also use Plugins, with personal setup where Developer Mode is permitted. Each AI client has its own guide and authorization requirements.

App connections

Salesforcen8nConfluence

Salesforce keeps connection context. Other providers use your signed-in account.

Connect HubSpot. Start with a safe read.

Use the AI you already work in while ApexGenius keeps the app route visible.

Connect HubSpot

1,000 free credits · No card required

Compatibility does not imply partnership.