Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.
Status: Available. Connect HubSpot through HubSpot’s official hosted MCP. You sign in on HubSpot’s own page and choose the portal. There is no API key to paste.Explore the HubSpot connector.
An account with permission to use the HubSpot resources you intend to connect.
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.
Open HubSpot in Connections and choose Connect. HubSpot then opens its own sign-in.
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 opens its own sign-in screen. Sign in to the account with access to your intended portal.
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.
Try a first question with your AI agent
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.
Compare the returned account and resource with HubSpot. Check the connection status separately from the result of the first read.
Create or update CRM records, properties, pipelines, segments, campaigns and landing pages.
Three ApexGenius tools reach HubSpot’s live catalog: one to search it, one to run tools HubSpot marks read-only, and one for everything else. Reads use the read route, so an AI agent set to Read only can use them. Enabled writes run immediately. Turn a tool off to block calls.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"ApexGenius","description":"Connect one app to a supported AI client, then keep the account, available operations, and observed Activity clear.","colors":{"primary":"#0055FF","light":"#4C7FE5","dark":"#4C7FE5"},"logo":{"light":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=ef6a088897a39f3ddbf23122743577fe","dark":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius-dark.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=90a72ff0da22baa182d13aa1ab8398d9","href":"https://www.apexgenius.ai"},"favicon":{"light":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=ef6a088897a39f3ddbf23122743577fe","dark":"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius-dark.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=90a72ff0da22baa182d13aa1ab8398d9"},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FAF9F6","dark":"#15171B"}},"navbar":{"links":[{"icon":"blocks","href":"https://www.apexgenius.ai/connectors","label":"Connectors"},{"icon":"workflow","href":"https://www.gatechsolutionsllc.com/services/agentforce-consulting","label":"Implementation help"}],"primary":{"type":"button","label":"Connect it free","href":"https://www.apexgenius.ai/auth"}},"footer":{"socials":{"x":"https://x.com/ApexGeniusAI","linkedin":"https://www.linkedin.com/company/apexgenius","youtube":"https://www.youtube.com/@ApexGeniusAI"},"links":[{"header":"ApexGenius","items":[{"label":"Product","href":"https://www.apexgenius.ai/mcp"},{"label":"Connector catalog","href":"https://www.apexgenius.ai/connectors"},{"label":"Security","href":"https://www.apexgenius.ai/security"}]},{"header":"Implementation","items":[{"label":"GAT Solutions services","href":"https://www.gatechsolutionsllc.com/services"},{"label":"AI and Agentforce consulting","href":"https://www.gatechsolutionsllc.com/services/agentforce-consulting"},{"label":"Salesforce integrations","href":"https://www.gatechsolutionsllc.com/services/salesforce-integrations"}]},{"header":"Legal","items":[{"label":"Privacy","href":"https://www.apexgenius.ai/privacy"},{"label":"Terms","href":"https://www.apexgenius.ai/terms"}]}]},"fonts":{"family":"Urbanist"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-7RKJ5X02QV"}},"errors":{"404":{"redirect":false,"title":"This route is not in the gateway docs","description":"Check the address or return to the [ApexGenius introduction](/getting-started/introduction)."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apexgenius","hasAudioNarration":false,"actualSubdomain":"apexgenius","customDomains":["docs.apexgenius.ai"],"gitSource":{"type":"github","owner":"ezscore","repo":"apexai","deployBranch":"main","contentDirectory":"content/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adf8dda83c1646dca34052e","collectionId":"e0816f0f-0792-45be-b62b-e511c2f006d7","liveDeploymentHistoryId":"6adf8dda83c1646dca34052e","schemaVersion":"v3"},"entitlements":{},"buildId":"6adf8dda83c1646dca34052e","clientVersion":"0.0.3969","searchFilterCounts":[{"language":"default","tag":"Connect apps","count":43},{"language":"default","tag":"Additional connector guides","count":33},{"language":"default","tag":"Connect an AI client","count":6},{"language":"default","tag":"Salesforce","count":5},{"language":"default","tag":"Start here","count":5},{"language":"default","tag":"Reference and support","count":4},{"language":"default","tag":"Governance and concepts","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--ag-canvas:#FAF9F6;--ag-surface:#FFFFFF;--ag-ink:#1A1A18;--ag-muted:#6B6B66;--ag-border:#E8E5DF;--ag-blue:#0055FF;--ag-blue-frame:rgb(0 85 255 / 18%);--ag-clay:#D97757}.dark{--ag-blue-frame:rgb(51 119 255 / 28%)}#navbar{border-bottom:1px solid var(--ag-blue-frame)}nav[aria-label=Pages]{border-right-color:var(--ag-blue-frame)}card,code-block{border-radius:14px}callout{border-radius:12px}@media (prefers-reduced-motion:reduce){*,::after,::before{scroll-behavior:auto!important;animation-duration:.01ms!important;animation-iteration-count:1!important;transition-duration:.01ms!important}}"}],"page":{"pagePath":"integrations/hubspot","slug":"/integrations/hubspot","pageMetadata":{"title":"HubSpot MCP Setup","description":"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.","href":"/integrations/hubspot"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Status: Available.`}),` Connect HubSpot through HubSpot’s official hosted MCP. You sign in on HubSpot’s own page and choose the portal. There is no API key to paste.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://www.apexgenius.ai/connectors/hubspot`,children:`Explore the HubSpot connector`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-and-check-your-account`,children:`Connect and check your account`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Before you start`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An account with permission to use the HubSpot resources you intend to connect.`}),`\n`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open HubSpot in Connections`,children:[_jsx(_components.p,{children:`Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.`}),_jsxs(Frame,{caption:`Open HubSpot in Connections and choose Connect. HubSpot then opens its own sign-in.`,children:[_jsx(OptimizedImage,{src:`https://www.apexgenius.ai/images/integration-guides/hubspot/20261025-open.webp`,alt:`The HubSpot page in ApexGenius before you connect, with the Connect button in the header and the Not connected empty state.`,className:`mint-hidden sm:mint-block`,width:`1200`,height:`476`,style:{width:`100%`,height:`auto`}}),_jsx(OptimizedImage,{src:`https://www.apexgenius.ai/images/integration-guides/hubspot/20261025-open-mobile.webp`,alt:`The HubSpot page in ApexGenius before you connect, with the Connect button in the header and the Not connected empty state.`,className:`mint-block sm:mint-hidden`,width:`780`,height:`899`,style:{width:`100%`,height:`auto`}})]})]}),_jsxs(Step,{title:`Choose the account and review access`,children:[_jsx(_components.p,{children:`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.`}),_jsx(Frame,{caption:`HubSpot opens its own sign-in screen. Sign in to the account with access to your intended portal.`,children:_jsx(OptimizedImage,{src:`https://www.apexgenius.ai/images/integration-guides/hubspot/20260906-signin.webp`,alt:`HubSpot’s official page for connecting an ApexGenius account, with Sign in to your HubSpot account.`,width:`500`,height:`458`,style:{width:`100%`,height:`auto`}})})]}),_jsx(Step,{title:`Review the connected account and resources`,children:_jsx(_components.p,{children:`Check the saved portal and account identity. If you have more than one HubSpot connection, choose the intended account before reviewing its Tools tab.`})}),_jsx(Step,{title:`Check the connection`,children:_jsx(_components.p,{children:`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.`})})]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Try a first question with your AI agent`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`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.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Compare the returned account and resource with HubSpot. Check the connection status separately from the result of the first read.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-your-ai-can-do`,children:`What your AI can do`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Confirm the connected user, portal and which objects it can read and write.`}),`\n`,_jsx(_components.li,{children:`Search and read contacts, companies, deals, tickets, leads and their activities.`}),`\n`,_jsx(_components.li,{children:`Query CRM data with HubSpot’s SQL, and find record owners.`}),`\n`,_jsx(_components.li,{children:`Read conversations, buyer intent signals, campaign results and marketing email analytics.`}),`\n`,_jsx(_components.li,{children:`Create or update CRM records, properties, pipelines, segments, campaigns and landing pages.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Three ApexGenius tools reach HubSpot’s live catalog: one to search it, one to run tools HubSpot marks read-only, and one for everything else. Reads use the read route, so an AI agent set to Read only can use them. Enabled writes run immediately. Turn a tool off to block calls.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Job`}),_jsx(_components.th,{children:`Reads`}),_jsx(_components.th,{children:`Writes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Account and schema`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`get_user_details`}),`, `,_jsx(_components.code,{children:`get_organization_details`}),`, `,_jsx(_components.code,{children:`discover_hubspot_schema`}),`, `,_jsx(_components.code,{children:`tool_guidance`})]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`CRM records`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`search_crm_objects`}),`, `,_jsx(_components.code,{children:`get_crm_objects`}),`, `,_jsx(_components.code,{children:`query_crm_data`}),`, `,_jsx(_components.code,{children:`search_owners`})]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`manage_crm_objects`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Properties, pipelines and segments`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`search_properties`}),`, `,_jsx(_components.code,{children:`get_properties`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`manage_custom_properties`}),`, `,_jsx(_components.code,{children:`manage_custom_pipelines`}),`, `,_jsx(_components.code,{children:`manage_segment`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Conversations and intent`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`search_conversations`}),`, `,_jsx(_components.code,{children:`get_conversation_channel_metadata`}),`, `,_jsx(_components.code,{children:`search_intent_signals`})]}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Campaigns and marketing email`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`read_campaign_data`}),`, `,_jsx(_components.code,{children:`get_campaign_attribution_reports`}),`, `,_jsx(_components.code,{children:`get_marketing_email_analytics`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`manage_campaign_objects`}),`, `,_jsx(_components.code,{children:`manage_marketing_email`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Content and AI search`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`get_content_analytics_report`}),`, `,_jsx(_components.code,{children:`get_aeo_metrics`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`manage_aeo_prompts`}),`, `,_jsx(_components.code,{children:`manage_aeo_recommendations`}),`, `,_jsx(_components.code,{children:`manage_landing_page`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Onboarding and feedback`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`manage_onboarding`}),`, `,_jsx(_components.code,{children:`submit_feedback`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`access-and-limits`,children:`Access and limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`HubSpot decides which tools a portal gets, from its subscription and your user permissions. Ask your AI to run `,_jsx(_components.code,{children:`get_user_details`}),` to see yours.`]}),`\n`,_jsx(_components.li,{children:`AI search tools need Marketing Hub Professional or Enterprise. Quotes need Revenue Hub Professional or Enterprise.`}),`\n`,_jsx(_components.li,{children:`When Sensitive Data is on in HubSpot, activity and conversation data does not reach the MCP.`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`search_crm_objects`}),` returns up to 200 records a page. `,_jsx(_components.code,{children:`get_crm_objects`}),` reads up to 100 ids at once.`]}),`\n`,_jsx(_components.li,{children:`HubSpot’s MCP creates and updates records but does not delete them. Publishing a landing page makes it public.`}),`\n`,_jsx(_components.li,{children:`Disconnecting stops future access. It does not undo a change that already ran.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If a layer fails (the connection, the tools, or the skill), HubSpot is `,_jsx(_components.strong,{children:`partially ready`}),`. A saved sign-in by itself does not make the connector usable.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A tool is missing:`}),` your HubSpot subscription or user permissions do not include it. Check `,_jsx(_components.code,{children:`get_user_details`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reconnect required:`}),` the HubSpot grant was revoked or expired. Choose Reconnect and sign in again.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A change is refused:`}),` the AI agent is set to Read only, or the write tool is off.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://www.apexgenius.ai/connectors/hubspot`,children:`Explore the HubSpot connector`}),` · `,_jsx(_components.a,{href:`https://www.apexgenius.ai/connections/hubspot`,children:`Open HubSpot Connections`})]}),`\n`,_jsx(Heading,{level:`2`,id:`official-hubspot-documentation`,children:`Official HubSpot documentation`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(`a`,{href:`https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server`,target:`_blank`,rel:`noreferrer`,children:`HubSpot remote MCP server`}),`\n`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"HubSpot MCP Setup","description":"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.","href":"/integrations/hubspot"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Connect and check your account","slug":"connect-and-check-your-account","depth":2,"children":[]},{"title":"What your AI can do","slug":"what-your-ai-can-do","depth":2,"children":[]},{"title":"Access and limits","slug":"access-and-limits","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Official HubSpot documentation","slug":"official-hubspot-documentation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n@media (min-width: 640px) {\n .sm\\:mint-block {\n display: block\n }\n .sm\\:mint-hidden {\n display: none\n }\n}","subdomain":"apexgenius","siteName":"ApexGenius","title":"HubSpot MCP Setup - ApexGenius","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T17:29:04.895Z","gitLastModified":"2026-10-26T17:00:33.000Z","originalFileLocation":"integrations/hubspot.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ApexGenius\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"HubSpot MCP Setup - ApexGenius\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ApexGenius\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apexgenius.ai/integrations/hubspot\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apexgenius.mintlify.app/_mintlify/api/og/v2?division=Additional+connector+guides\u0026amp;title=HubSpot+MCP+Setup\u0026amp;description=Connect+HubSpot+through+its+official+MCP.+Search+contacts%2C+companies+and+deals%2C+and+create+or+update+CRM+records+from+your+AI+agent.\u0026amp;theme=19ac6d0290a1eaf9945bbd0f\u0026amp;signature=89cc6115b9d09eb2757de61404ce9b1c7200d57b2b276e79e50f720519f684c9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"HubSpot MCP Setup - ApexGenius\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apexgenius.mintlify.app/_mintlify/api/og/v2?division=Additional+connector+guides\u0026amp;title=HubSpot+MCP+Setup\u0026amp;description=Connect+HubSpot+through+its+official+MCP.+Search+contacts%2C+companies+and+deals%2C+and+create+or+update+CRM+records+from+your+AI+agent.\u0026amp;theme=19ac6d0290a1eaf9945bbd0f\u0026amp;signature=89cc6115b9d09eb2757de61404ce9b1c7200d57b2b276e79e50f720519f684c9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/apexgenius/of2iO4EQJQd_LzS2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ApexGenius\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0055FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apexgenius.ai/integrations/hubspot\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/hubspot.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apexgenius.ai/#organization\",\"name\":\"ApexGenius\",\"url\":\"https://docs.apexgenius.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apexgenius/PL1VOuYeZtypECmH/logo/apexgenius.svg?fit=max\u0026auto=format\u0026n=PL1VOuYeZtypECmH\u0026q=85\u0026s=ef6a088897a39f3ddbf23122743577fe\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apexgenius.ai#website\",\"name\":\"ApexGenius\",\"url\":\"https://docs.apexgenius.ai\",\"publisher\":{\"@id\":\"https://docs.apexgenius.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apexgenius.ai/integrations/hubspot#webpage\",\"url\":\"https://docs.apexgenius.ai/integrations/hubspot\",\"name\":\"HubSpot MCP Setup\",\"description\":\"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.\",\"dateModified\":\"2026-10-26T17:00:33.000Z\",\"isPartOf\":{\"@id\":\"https://docs.apexgenius.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apexgenius.ai/integrations/hubspot#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apexgenius.ai/integrations/hubspot#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connect apps\",\"item\":\"https://docs.apexgenius.ai/integrations/provider-connections\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Additional connector guides\",\"item\":\"https://docs.apexgenius.ai/integrations/hq-rental\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"HubSpot MCP Setup\",\"item\":\"https://docs.apexgenius.ai/integrations/hubspot\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.apexgenius.ai/integrations/hubspot#article\",\"headline\":\"HubSpot MCP Setup\",\"name\":\"HubSpot MCP Setup\",\"description\":\"Connect HubSpot through its official MCP. Search contacts, companies and deals, and create or update CRM records from your AI agent.\",\"url\":\"https://docs.apexgenius.ai/integrations/hubspot\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apexgenius.ai/integrations/hubspot#webpage\"},\"dateModified\":\"2026-10-26T17:00:33.000Z\",\"publisher\":{\"@id\":\"https://docs.apexgenius.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apexgenius.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ApexGenius\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ApexGenius","nav":{"global":null,"groups":[{"group":"Start here","icon":"route","pages":[{"title":"Connect one app to the AI you already use","href":"/getting-started/introduction"},{"title":"Connect an AI client","href":"/guides/mcp-setup"},{"title":"Send the first safe request","href":"/guides/first-safe-request"},{"title":"Skills","href":"/guides/skills"},{"title":"Memory","href":"/guides/memory"}]},{"group":"Connect an AI client","icon":"message-square-code","pages":[{"title":"Connect Claude","href":"/guides/connect-claude"},{"title":"Connect ChatGPT","href":"/guides/connect-chatgpt"},{"title":"Connect Codex","href":"/guides/connect-codex"},{"title":"Connect Cursor","href":"/guides/connect-cursor"},{"title":"Connect VS Code","href":"/guides/connect-vscode"},{"title":"Connect Claude Code","href":"/guides/connect-claude-code"}]},{"group":"Salesforce","icon":"cloud","pages":[{"title":"Connect Salesforce","href":"/getting-started/connect-salesforce"},{"title":"Loading Metadata","href":"/getting-started/load-metadata"},{"title":"Using the Account App","href":"/getting-started/using-chat"},{"title":"Reports and Dashboards: Current Availability","href":"/guides/reports-and-dashboards"},{"title":"Salesforce connection model","href":"/integrations/salesforce-connection"}]},{"group":"Connect apps","icon":"plug-zap","pages":[{"title":"App connection guides","href":"/integrations/provider-connections"},{"title":"YouTube MCP Setup","href":"/integrations/youtube"},{"title":"YouTube Analytics MCP Setup","href":"/integrations/youtube-analytics"},{"title":"n8n MCP Setup","href":"/integrations/n8n"},{"title":"Confluence MCP Setup","href":"/integrations/confluence"},{"title":"Discord MCP Setup","href":"/integrations/discord"},{"title":"Jira MCP Setup","href":"/integrations/jira"},{"group":"Additional connector guides","icon":"flask-conical","pages":[{"title":"HQ Rental MCP Setup","href":"/integrations/hq-rental"},{"title":"Google Ads MCP Setup","href":"/integrations/google-ads"},{"title":"Google Search Console MCP Setup","href":"/integrations/google-search-console"},{"title":"Google Analytics MCP Setup","href":"/integrations/google-analytics"},{"title":"Google Workspace MCP Setup","href":"/integrations/google-workspace"},{"title":"Upwork MCP Setup","href":"/integrations/upwork"},{"title":"Apollo MCP Setup","href":"/integrations/apollo"},{"title":"Notion MCP Setup","href":"/integrations/notion"},{"title":"Connect Slack accounts","href":"/integrations/slack"},{"title":"ClickUp MCP Setup","href":"/integrations/clickup"},{"title":"Connect Blotato","href":"/integrations/blotato"},{"title":"Connect HighLevel","href":"/integrations/gohighlevel"},{"title":"ChatGPT Ads MCP Setup","href":"/integrations/chatgpt-ads"},{"title":"Semrush MCP Setup","href":"/integrations/semrush"},{"title":"Bing Webmaster MCP Setup","href":"/integrations/bing-webmaster"},{"title":"Apify MCP Setup","href":"/integrations/apify"},{"title":"Linear MCP Setup","href":"/integrations/linear"},{"title":"Attio MCP Setup","href":"/integrations/attio"},{"title":"Calendly MCP Setup","href":"/integrations/calendly"},{"title":"Connect Cal.com to your AI","href":"/integrations/cal-com"},{"title":"Mobbin MCP Setup","href":"/integrations/mobbin"},{"title":"Supabase MCP Setup","href":"/integrations/supabase"},{"title":"Context.dev MCP Setup","href":"/integrations/context-dev"},{"title":"Stripe MCP Setup","href":"/integrations/stripe"},{"title":"GitHub MCP Setup","href":"/integrations/github"},{"title":"monday.com MCP Setup","href":"/integrations/monday"},{"title":"Atlassian Rovo MCP Setup","href":"/integrations/atlassian-rovo"},{"title":"ElevenLabs MCP Setup","href":"/integrations/elevenlabs"},{"title":"FreshBooks MCP Setup","href":"/integrations/freshbooks"},{"title":"Trello MCP Setup","href":"/integrations/trello"},{"title":"GitLab MCP Setup","href":"/integrations/gitlab"},{"title":"TypeSafe MCP Setup","description":"Connect TypeSafe with an API key. Ask Jev typed yes/no, score and choice questions about search terms, ads and leads from your AI agent.","href":"/integrations/typesafe"},{"title":"HubSpot MCP Setup","href":"/integrations/hubspot"}]},{"title":"Connect Speedrun Alpha","description":"Read current Speedrun Alpha requirements and prepare a reviewed application with your AI. Applicant access is enabled separately.","href":"/integrations/speedrun"},{"title":"Connect OP.GG to your AI","href":"/integrations/opgg"},{"title":"Read Polymarket information with your AI","href":"/integrations/polymarket"}]},{"group":"Governance and concepts","icon":"shield-check","pages":[{"title":"How the MCP Connection Works","href":"/concepts/how-mcp-works"},{"title":"Orgs, Projects \u0026 Workspaces","href":"/concepts/orgs-and-projects"},{"title":"The Soul Doc","href":"/concepts/soul-doc"}]},{"group":"Reference and support","icon":"book-open-check","pages":[{"title":"MCP Tool Reference","href":"/reference/mcp-tools"},{"title":"Pricing and Account Limits","href":"/reference/plans-and-limits"},{"title":"Common Issues","href":"/troubleshooting/common-issues"},{"title":"How we record your signup source","href":"/reference/signup-source"}]}]},"title":"HubSpot MCP Setup - ApexGenius","buildId":"dpl_G8u2B2Ji9qJYF9umedjv293TxycS","deploymentId":"dpl_G8u2B2Ji9qJYF9umedjv293TxycS","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-CKfAdMi0.js","DynamicMarkdown-DpsHMHVL.js","zoom-image-lightbox-Io6GMTYV.js","lightbox-handle-r17bVUz3.js"]}
