Available

HubSpot MCP server

Prepare account reviews and keep contacts, companies, and deals current with Arc0’s HubSpot tools. Agents can read CRM records, make targeted changes, and record meeting notes. Connect through Arc0 to use the actions your identity is allowed to call.

CRMOAuthMCP + RESThubspot.com
AUDIT LOG · HUBSPOTPOLICY: acme-support
09:41:07 · claude · u_8f2read
hubspot.list_owners
List owners✓ allowed · 212ms
09:41:08 · claude · u_8f2read
hubspot.get_deal
Get deal✓ allowed · 164ms
09:41:09 · claude · u_8f2write
hubspot.create_deal
Create deal✓ approved · approved by user
ILLUSTRATIVE POLICY TRACE · NOT A LIVE RECEIPT

Working with HubSpot

Before a pipeline meeting, ask your agent to find the opportunities that need attention with hubspot.search_deals. hubspot.get_deal retrieves the fields needed for each review. hubspot.get_account supplies account currency and time zone, which matter when interpreting amounts and close dates across teams.

For a new prospect, search contacts and companies before creating records. hubspot.search_contacts helps identify an existing person; hubspot.search_companies can find the associated business. hubspot.create_contact can link the new contact to an existing company. Finding a company by domain first avoids creating another account record merely because the prospect used a different spelling.

After a meeting, use hubspot.create_note to attach the agreed next steps to the appropriate record IDs. hubspot.list_owners supplies owner IDs for a reassignment, and hubspot.update_deal changes a known opportunity’s stage or close date. Verify writes through the corresponding get action because search indexing can lag. The current tools do not send marketing email or delete CRM records.

Official MCP reference: HubSpot documentation.

01 · USE CASES

Agent workflows for HubSpot.

01

Prepare a deal review

Use hubspot.search_deals and hubspot.get_deal to gather the stage, amount, and close date of selected opportunities.

02

Add a qualified contact

Use hubspot.search_contacts before hubspot.create_contact to avoid adding a second record for the same email.

03

Assign the right owner

Use hubspot.list_owners for owner IDs, then hubspot.update_contact or hubspot.update_deal to apply the assignment.

04

Keep meeting context attached

Use hubspot.create_note to attach a reviewed summary to existing contacts, companies, or deals.

02 · ACTIONS

15 HubSpot actions, graded by risk.

These actions come from the Arc0 registry. Your identity, provider permissions and Arc0 policies determine which actions can run.

read

8

Look things up, subject to your permissions.

  • hubspot.search_contacts
    Search contacts

    Find HubSpot contacts by free text (name, email, phone, company) or property filters, up to 100 per page. Use when the user asks who is in the CRM, looks up a person, or needs contact ids. To continue, pass nextCursor as after.

  • hubspot.get_contact
    Get contact

    Read one HubSpot contact by record id or email address, with the properties you name. Use when the user asks for details about a specific person already in the CRM. For fuzzy lookups use search_contacts instead.

  • hubspot.search_companies
    Search companies

    Find HubSpot companies by free text (name, domain, website, phone) or property filters, up to 100 per page. Use when the user asks about an account or organization in the CRM or needs company ids. To continue, pass nextCursor as after.

  • hubspot.get_company
    Get company

    Read one HubSpot company by record id, with the properties you name (for example name, domain, industry, numberofemployees). Use when the user asks for details about a specific company already in the CRM.

  • hubspot.search_deals
    Search deals

    Find HubSpot deals by free text (deal name, stage, type) or property filters such as dealstage, amount or closedate, up to 100 per page. Use when the user asks about the pipeline, open opportunities or a specific deal. To continue, pass nextCursor as after.

  • hubspot.get_deal
    Get deal

    Read one HubSpot deal by record id, with the properties you name (for example dealname, amount, dealstage, closedate, hubspot_owner_id). Use when the user asks about the status or value of a specific deal.

  • hubspot.list_owners
    List owners

    List HubSpot owners (users who can own records) with their owner id, name, email and teams, optionally filtered by email. Use when the user wants to assign a contact, company, deal or note to someone and you need the ownerId.

  • hubspot.get_account
    Get account details

    Show the connected HubSpot account: hub id, name, account type, time zone, company currency and data hosting region. Use when the user asks which HubSpot portal is connected, or before writing deal amounts or dates that depend on currency or time zone.

write

7

Create and change things. Allow, or ask the user first.

  • hubspot.create_contact
    Create contact

    Create one HubSpot contact, optionally linked to existing companies. Use when the user asks to add a person to the CRM. Search first: HubSpot rejects a second contact with the same email. Not for editing an existing contact.

  • hubspot.update_contact
    Update contact

    Change properties on one HubSpot contact by record id, for example jobtitle, phone, lifecyclestage or hubspot_owner_id; an empty string clears a value. Use when the user asks to correct or enrich a contact already in the CRM.

  • hubspot.create_company
    Create company

    Create one HubSpot company record from a name and/or website domain. Use when the user asks to add an organization or account to the CRM. Search by domain first to avoid duplicates. Not for editing an existing company.

  • hubspot.update_company
    Update company

    Change properties on one HubSpot company by record id, for example domain, industry, numberofemployees or hubspot_owner_id; an empty string clears a value. Use when the user asks to correct or enrich a company already in the CRM.

  • hubspot.create_deal
    Create deal

    Create one HubSpot deal in a pipeline stage, optionally with amount, close date, owner and linked contacts or companies. Use when the user asks to open or log a new opportunity. Not for moving an existing deal; use update_deal.

  • hubspot.update_deal
    Update deal

    Change properties on one HubSpot deal by record id, for example move it to another dealstage, set amount or closedate, or reassign hubspot_owner_id. Use when the user asks to progress, win, lose or edit an existing deal.

  • hubspot.create_note
    Log note

    Log a note on the timeline of HubSpot contacts, companies and/or deals, for example a call summary or meeting outcome. Use when the user asks to record what happened with a customer. Needs at least one contact, company or deal id.

destructive

0

Delete, cancel or archive. Ask first, or deny outright.

  • No destructive actions.
03 · POLICIES AND AUDIT

Control access to HubSpot.

Connect the intended HubSpot account, authorize your AI client and set policies for its tools.

Provider permissions and Arc0 policy both apply. Allow reads, require approval for selected writes, or deny destructive actions. The audit log records execution decisions.

Configure policies and approvals

Example policy choices

  • Read actions: allow where authorized
  • hubspot.create_deal: require approval

Arc0 MCP endpoint: https://api.arc0.ai/mcp

04 · AUTH AND DATA

How HubSpot connects.

Connect HubSpot using OAuth. OAuth grants the provider scopes shown during consent; API keys and other credentials retain the permissions configured at the provider. Arc0 stores credentials in its encrypted vault and does not pass them to the model. Disconnect to remove access through Arc0; revoke a key at the provider to invalidate it there. Token refresh and provider-side revocation depend on the authentication lane and provider.

The connection serves authorized calls through Arc0 MCP and REST. How Arc0 handles credentials →

AUTH
OAuth
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · AI CLIENTS

Use HubSpot with your AI client.

Sign in to Arc0 and connect HubSpot in My apps. Then authorize your AI client separately. It only receives tools and accounts allowed for that identity.

HubSpot with Claude

Claude Desktop + Claude Code

  1. In Claude Desktop, add Arc0 through the remote MCP settings and use OAuth. Follow the generic remote-client steps if your account’s interface differs.
  2. For Claude Code, run the command below. Open /mcp, select Arc0, and authenticate in your browser. Select your workspace and review access.
  3. Check the connection with claude mcp get arc0.
claude mcp add --transport http --scope user arc0 https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for Claude
HubSpot with ChatGPT

ChatGPT on the web

  1. Open Plugins in ChatGPT, select the plus button, then Add custom MCP server.
  2. Name it Arc0, enter the server URL below, and choose OAuth. Use dynamic client registration if asked; no Arc0 API key is needed.
  3. Review the notice and select Create as a plugin. Complete Arc0 sign-in, workspace selection and consent, then install and select the plugin in your conversation. Labels and access vary by account; managed workspaces may require administrator approval.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for ChatGPT
HubSpot with OpenAI Codex

Codex app + CLI

  1. Run the registration command below. The app and CLI share ~/.codex/config.toml.
  2. Complete browser OAuth, choose your Arc0 workspace, and review access. If authentication does not start, run codex mcp login arc0.
  3. Check codex mcp list, then open a new Codex chat. Inspect an existing arc0 entry before changing it.
codex mcp add arc0 --url https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for OpenAI Codex
HubSpot with Cursor

Remote MCP setup

  1. Add Arc0 in your client’s remote MCP settings using the server URL below.
  2. Choose OAuth, sign in to Arc0, select the intended workspace and review access.
  3. Confirm the server is connected and start with an allowed read. These are generic remote-MCP steps; consult your client’s settings for its current interface.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
All apps for Cursor
HubSpot with VS Code

Remote MCP setup

  1. Add a remote HTTP MCP server named Arc0 using the URL below.
  2. Use OAuth and finish Arc0 sign-in, workspace selection and consent.
  3. Confirm discovery succeeds before requesting a read. These are generic remote-MCP steps; client UI and availability may differ.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting
HubSpot with Any MCP client

Streamable HTTP

  1. Use a client that supports remote MCP over Streamable HTTP. Add the server URL below and choose OAuth.
  2. For a client without OAuth, use a self-bound API key with execute permission in the X-API-Key header. Store it in secret storage or an environment variable, outside source control. Never send both an API key and an OAuth bearer token.
  3. Use the MCP clients guide for the SDK transport example and Embedded identity for business-managed end users.
https://api.arc0.ai/mcp
Full MCP setup and troubleshooting

After setup, ask your agent to find an allowed read action, load its schema, and execute it on the intended account. Check Activity for the receipt. A connected MCP client alone does not confirm a successful provider call.

07 · FAQ

HubSpot and Arc0, answered.

Q01

Is there an official HubSpot MCP server, and how does Arc0 differ?

Yes. HubSpot documents a remote CRM MCP server and a separate developer MCP server. Arc0 uses a defined REST action set for contacts, companies, deals, notes, and owners under the same policies as other apps.

Q02

Which permissions does Arc0 need for HubSpot?

OAuth requests oauth, crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.companies.read, crm.objects.companies.write, crm.objects.deals.read, crm.objects.deals.write and crm.objects.owners.read. These app grants can reach contacts beyond the installing user’s record visibility.

Q03

Does this work with Claude, ChatGPT, Codex and Cursor?

Yes, through Arc0 MCP when your Claude, ChatGPT, Codex, or Cursor client supports remote MCP and your account permits it. Connect the app in Arc0 and configure your client using the Arc0 setup guide. App permissions still apply.

Q04

How are credentials stored, refreshed and revoked?

Credentials are encrypted in Arc0’s vault. Arc0 stores access and refresh tokens and refreshes expiring access. Disconnect removes the local credential without revoking a shared installation. Remove the app in HubSpot for installation-wide removal; refresh-token revocation does not immediately invalidate already-issued access tokens.

Q05

What happens with rate limits or errors?

HubSpot limits CRM search separately from other API traffic. Arc0 reports throttling, missing scopes, and invalid inputs. Search can lag a write, so read a known record directly when checking whether a change succeeded.

Q06

What is the availability of these HubSpot tools?

These tools are available. Connect the app in Arc0 and authorize your AI client. The action list describes the current implementation.

Get started

Plug HubSpot into your agent.

HubSpot MCP server: 15 actions including search contacts, get contact, create contact. Connect through Arc0.

Free to build · MCP + REST · Audit log on every plan

HubSpot and its logo are trademarks of their respective owners. Arc0 is not affiliated with or endorsed by HubSpot.