Skip to content

Connect Cursor to HubSpot

Connect Cursor to HubSpot in 3 steps: 1. Sign in to ApexGenius and connect HubSpot. 2. Add the ApexGenius MCP server. 3. Start using HubSpot in Cursor.

1,000 free credits · No card required

How to connect HubSpot to Cursor

  1. 1Sign in to ApexGenius and connect HubSpot
  2. 2Add the ApexGenius MCP server to Cursor
  3. 3Start using HubSpot in Cursor
  1. 1ApexGenius

    Connect HubSpot to ApexGenius

    Open HubSpot in ApexGenius

    Open HubSpot in Connections and choose Connect.

  2. 2HubSpot

     

    Connect HubSpot

    HubSpot opens its own sign-in. Sign in and allow ApexGenius.

  3. 3ApexGenius

    Connect ApexGenius to Cursor

    Choose Cursor

    Back on Start, pick Cursor and copy the prompt.

  4. 4ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius MCP server to Cursor

Cursor reads MCP servers from ~/.cursor/mcp.json for every project, or from .cursor/mcp.json inside one project. The Customize page manages the same servers.

  1. Add the apexgenius entry to mcpServers. Keep any servers already there.
  2. Open Customize in Cursor, find apexgenius and choose Connect.
  3. Approve ApexGenius in your browser.
Add to ~/.cursor/mcp.json
{
  "mcpServers": {
    "apexgenius": {
      "url": "https://server.autom8.pro/mcp"
    }
  }
}

Check it. Cursor lists a connected server’s tools under Available Tools. By default it asks for your approval before it runs one.

Steps follow Cursor documentation, Model Context Protocol (MCP) (opens in a new tab), read November 12, 2026.

Then ask Cursor

Find the available HubSpot account identity read tool, then use it to show which HubSpot account is connected. Do not retrieve contacts or change anything.

Start free
Written setup, step by stepShow

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. Connect ApexGenius to Cursor

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The steps are above, under Add the ApexGenius MCP server to Cursor. These notes apply to Cursor only.

  • No client ID or secret. Cursor signs in with OAuth and registers itself with ApexGenius, so mcp.json needs only the address.
  • Enterprise teams. An MCP allowlist can limit which server addresses run. If apexgenius does not connect on a team account, ask your Cursor admin to allow the ApexGenius address.
  • Turning it off. Enable or disable the server from Customize in the sidebar.
  • Access. When ApexGenius asks what Cursor may use, choose Read only for the first test, or Custom to limit it to the tools you need.

3. Try your first question

Find the available HubSpot account identity read tool, then use it to show which HubSpot account is connected. Do not retrieve contacts or change anything.

Find the available HubSpot account identity read tool, then use it to show which HubSpot account is connected. Do not retrieve contacts or change anything.

Check that the answer matches what you see in HubSpot.

Full guide: the HubSpot setup guide.

What it looks like in Cursor

Example workflow
Cursor
CursorApexGenius MCP route
Which HubSpot account is connected, and which objects can I read and write? Do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestCheck the account
Account scopeAuthorized connections checked
apex_search_toolsHubSpot account · Find HubSpot readsComplete
apex_call_read_toolget_user_details · Read the connected user and accessComplete
Cursor

The connected portal is Example Co. Contacts, companies, deals and tickets can be read and written.

Read-only route
Cursor

What to ask Cursor about HubSpot

  • Check the account

    Which HubSpot account is connected, and which objects can I read and write? Do not change anything.

    Runs get_user_details (read).

  • Open deals

    Which deals are open this month, with their stage, amount and owner?

    Runs search_crm_objects (read), then search_owners (read).

  • Look up a contact

    Find the contact with the email I give you and show their company and recent activity.

    Runs search_crm_objects (read), then get_crm_objects (read).

These 3 questions use 4 of HubSpot’s 29 operations. The full list is below.

  • Create a deal for the company I name with the amount and close date I give you. Show me the record first. (write)

What Cursor can do in HubSpot

29 operations: 18 read, 11 write. Read looks things up and changes nothing. Writes change HubSpot and run only when you turn them on.

Account and schema

4 read
  • get_user_detailsread
  • get_organization_detailsread
  • discover_hubspot_schemaread
  • tool_guidanceread

CRM records

4 read · 1 write
  • search_crm_objectsread
  • get_crm_objectsread
  • query_crm_dataread
  • search_ownersread
  • manage_crm_objectswrite

Properties, pipelines and segments

2 read · 3 write
  • search_propertiesread
  • get_propertiesread
  • manage_custom_propertieswrite
  • manage_custom_pipelineswrite
  • manage_segmentwrite

Conversations and intent

3 read
  • search_conversationsread
  • get_conversation_channel_metadataread
  • search_intent_signalsread

Campaigns and marketing email

3 read · 2 write
  • read_campaign_dataread
  • get_campaign_attribution_reportsread
  • get_marketing_email_analyticsread
  • manage_campaign_objectswrite
  • manage_marketing_emailwrite

Content and AI search

2 read · 3 write
  • get_content_analytics_reportread
  • get_aeo_metricsread
  • manage_aeo_promptswrite
  • manage_aeo_recommendationswrite
  • manage_landing_pagewrite

Onboarding and feedback

2 write
  • manage_onboardingwrite
  • submit_feedbackwrite

You choose the access. When you approve Cursor, pick Full access, Read only, or Custom.

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

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

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.

HubSpot’s MCP creates and updates records but does not delete them. Publishing a landing page makes it public.

Start free

Questions about connecting Cursor to HubSpot

Updated November 12, 2026.

How do I connect Cursor to HubSpot?

Sign in to ApexGenius and connect HubSpot. In Cursor, add an apexgenius entry with the ApexGenius MCP address to mcpServers in ~/.cursor/mcp.json, then choose Connect on the Customize page. Then ask Cursor: “Find the available HubSpot account identity read tool, then use it to show which HubSpot account is connected. Do not retrieve contacts or change anything.” Start with a read, so nothing changes.

How do I check that Cursor can use HubSpot?

Open Customize in Cursor and find apexgenius among the MCP servers. Its tools should appear under Available Tools. If it is listed but not connected, choose Connect and finish the browser sign-in. On an Enterprise team, the MCP allowlist may need the ApexGenius address. Then ask: “Find the available HubSpot account identity read tool, then use it to show which HubSpot account is connected. Do not retrieve contacts or change anything.”

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.

Connect HubSpot to Cursor today

Start free

1,000 free credits. No card required. Disconnect any time.