Connect an Attio workspace to ApexGenius through Attio’s official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.
Status: Available. Attio uses its official hosted MCP server and browser
OAuth. You do not paste an Attio API key. The connection acts as the Attio user
who signs in, so that user’s workspace permissions set what your AI can reach.Explore the Attio connector.
What you need
An active Attio workspace
An Attio user with access to the records you intend to use
An ApexGenius account
How to connect Attio
Before you start
An account with permission to use the Attio resources you intend to connect.
1
Open Attio 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.
2
Choose the account and review access
Sign in to Attio in the browser, choose the workspace, and allow access. Attio uses browser authorization; no API key is pasted into ApexGenius.
Connect opens Attio's sign-in. Sign in with Google or your work email, then allow ApexGenius.
3
Review the connected account and resources
Confirm the connected Attio user and workspace. Open Tools to review the record, list, note and task actions. Your Attio permissions set what the connection can reach.
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
Use whoami to show which Attio user and workspace are connected, then list the lists in my workspace. Do not change anything.
Open Skills on the connection to read Attio, or read that MCP prompt in
a compatible AI client with prompts/get. It covers the first safe read, the
read and write routes, and what cannot be undone.Three ApexGenius tools route Attio’s live catalog:
ApexGenius tool
What it does
Access
attio_search_tools
Lists Attio’s current operations with their schemas
Read
attio_call_read_tool
Runs an operation only when Attio’s live catalog marks it read-only, such as whoami, search-records, list-records-in-list, get-note-body or run-basic-report
Read
attio_call_tool
Runs changes such as create-record, update-record, add-record-to-list, create-note, create-task, merge-records and delete-comment
Write
Attio documents 41 operations: 26 reads and 15 changes. The full list, grouped
by job, is on the Attio connector page.Your AI discovers the tools with apex_search_tools. Reads use
apex_call_read_tool; changes use apex_call_write_tool. Writes run immediately. Blocked hides a tool from agents.
What cannot be undone
merge-records joins two records into one. It cannot be undone here.
delete-comment removes a comment you created and every reply under it.
There is no delete for records, lists, list entries, notes or tasks. Remove
anything created by mistake by hand in Attio.
Text added with update-note must be removed by hand in Attio.
Updated records, list entries and tasks can be put back by writing the old
values again.
Disconnecting stops future access. It does not undo a change that already ran.
Connector, tools, and skill
Layer
What must work
Connector
OAuth completes, the connected Attio user and workspace are shown, and health is current.
Tools
attio_search_tools, attio_call_read_tool and attio_call_tool are discoverable and a real read such as whoami succeeds.
Skill
The Attio MCP prompt is readable and routes the agent through discovery, the read route, and the undo limits.
If any row fails, Attio is partially ready. A saved OAuth record by itself
is not a fully ready connection.
Troubleshooting
Unavailable to this account: check that you are signed in to the intended ApexGenius account and refresh Connections.
Reconnect required: use the connection page to renew the saved authorization.
A record or tool is missing: check the Attio user’s permissions and the tool settings for your AI agent. Do not expand access just to make a test pass.
SQL failed:query-particle-sql is not on every Attio plan. Ask for the same numbers with run-basic-report.
Rate limited: Attio limits calls per workspace. Semantic search, reports and SQL allow two calls a second. Space out bulk work.
Tool disabled: the owner has turned the tool off. Review tool access on the connection page.
{"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":""},"entitlements":{},"buildId":"6af73179bd8b0362cded89b8","clientVersion":"0.0.4143","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":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"workos-sso-scim","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},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"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{border-radius:14px}code-block{border-radius:14px}callout{border-radius:12px}@media (prefers-reduced-motion: reduce){*,*::before,*::after{scroll-behavior:auto!important;animation-duration:0.01ms!important;animation-iteration-count:1!important;transition-duration:0.01ms!important}}"}],"page":{"pagePath":"integrations/attio","slug":"/integrations/attio","pageMetadata":{"title":"Attio MCP Setup","description":"Connect an Attio workspace to ApexGenius through Attio's official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.","href":"/integrations/attio"},"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 an Attio workspace to ApexGenius through Attio’s official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.\"\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},{Accordion,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);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.`}),` Attio uses its official hosted MCP server and browser\nOAuth. You do not paste an Attio API key. The connection acts as the Attio user\nwho signs in, so that user’s workspace permissions set what your AI can reach.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://www.apexgenius.ai/connectors/attio`,children:`Explore the Attio connector`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-need`,children:`What you need`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An active Attio workspace`}),`\n`,_jsx(_components.li,{children:`An Attio user with access to the records you intend to use`}),`\n`,_jsx(_components.li,{children:`An ApexGenius account`}),`\n`]}),`\n`,_jsxs(Accordion,{title:`How to connect Attio`,id:`how-to-connect-attio`,children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Before you start`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An account with permission to use the Attio resources you intend to connect.`}),`\n`]}),_jsxs(Steps,{children:[_jsx(Step,{title:`Open Attio 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(Step,{title:`Choose the account and review access`,children:[_jsx(_components.p,{children:`Sign in to Attio in the browser, choose the workspace, and allow access. Attio uses browser authorization; no API key is pasted into ApexGenius.`}),_jsx(Frame,{caption:`Connect opens Attio's sign-in. Sign in with Google or your work email, then allow ApexGenius.`,children:_jsx(OptimizedImage,{src:`https://www.apexgenius.ai/images/integration-guides/attio/20260923-sign-in.webp`,alt:`The full Attio sign-in page that opens when you connect Attio, with a red box around the sign-in options.`,width:`1323`,height:`896`,style:{width:`100%`,height:`auto`}})})]}),_jsx(Step,{title:`Review the connected account and resources`,children:_jsx(_components.p,{children:`Confirm the connected Attio user and workspace. Open Tools to review the record, list, note and task actions. Your Attio permissions set what the connection can reach.`})}),_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.`})})]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Try a first question with your AI agent`})}),_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:`Use whoami to show which Attio user and workspace are connected, then list the lists in my workspace. Do not change anything.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Compare the returned account and resource with Attio. Check the connection status separately from the result of the first read.`}),_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/guides/mcp-setup`,children:`Add your AI agent`}),` · `,_jsx(_components.a,{href:`https://docs.attio.com/mcp/overview`,children:`Official Attio instructions`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`tools-and-the-attio-skill`,children:`Tools and the Attio skill`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Skills`}),` on the connection to read `,_jsx(_components.strong,{children:`Attio`}),`, or read that MCP prompt in\na compatible AI client with `,_jsx(_components.code,{children:`prompts/get`}),`. It covers the first safe read, the\nread and write routes, and what cannot be undone.`]}),`\n`,_jsx(_components.p,{children:`Three ApexGenius tools route Attio’s live catalog:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`ApexGenius tool`}),_jsx(_components.th,{children:`What it does`}),_jsx(_components.th,{children:`Access`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`attio_search_tools`})}),_jsx(_components.td,{children:`Lists Attio’s current operations with their schemas`}),_jsx(_components.td,{children:`Read`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`attio_call_read_tool`})}),_jsxs(_components.td,{children:[`Runs an operation only when Attio’s live catalog marks it read-only, such as `,_jsx(_components.code,{children:`whoami`}),`, `,_jsx(_components.code,{children:`search-records`}),`, `,_jsx(_components.code,{children:`list-records-in-list`}),`, `,_jsx(_components.code,{children:`get-note-body`}),` or `,_jsx(_components.code,{children:`run-basic-report`})]}),_jsx(_components.td,{children:`Read`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`attio_call_tool`})}),_jsxs(_components.td,{children:[`Runs changes such as `,_jsx(_components.code,{children:`create-record`}),`, `,_jsx(_components.code,{children:`update-record`}),`, `,_jsx(_components.code,{children:`add-record-to-list`}),`, `,_jsx(_components.code,{children:`create-note`}),`, `,_jsx(_components.code,{children:`create-task`}),`, `,_jsx(_components.code,{children:`merge-records`}),` and `,_jsx(_components.code,{children:`delete-comment`})]}),_jsx(_components.td,{children:`Write`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Attio documents 41 operations: 26 reads and 15 changes. The full list, grouped\nby job, is on the `,_jsx(_components.a,{href:`https://www.apexgenius.ai/connectors/attio`,children:`Attio connector page`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Your AI discovers the tools with `,_jsx(_components.code,{children:`apex_search_tools`}),`. Reads use\n`,_jsx(_components.code,{children:`apex_call_read_tool`}),`; changes use `,_jsx(_components.code,{children:`apex_call_write_tool`}),`. Writes run immediately. Blocked hides a tool from agents.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-cannot-be-undone`,children:`What cannot be undone`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`merge-records`}),` joins two records into one. It cannot be undone here.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`delete-comment`}),` removes a comment you created and every reply under it.`]}),`\n`,_jsx(_components.li,{children:`There is no delete for records, lists, list entries, notes or tasks. Remove\nanything created by mistake by hand in Attio.`}),`\n`,_jsxs(_components.li,{children:[`Text added with `,_jsx(_components.code,{children:`update-note`}),` must be removed by hand in Attio.`]}),`\n`,_jsx(_components.li,{children:`Updated records, list entries and tasks can be put back by writing the old\nvalues again.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Disconnecting stops future access. It does not undo a change that already ran.`}),`\n`,_jsx(Heading,{level:`2`,id:`connector-tools-and-skill`,children:`Connector, tools, and skill`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Layer`}),_jsx(_components.th,{children:`What must work`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Connector`}),_jsx(_components.td,{children:`OAuth completes, the connected Attio user and workspace are shown, and health is current.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tools`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`attio_search_tools`}),`, `,_jsx(_components.code,{children:`attio_call_read_tool`}),` and `,_jsx(_components.code,{children:`attio_call_tool`}),` are discoverable and a real read such as `,_jsx(_components.code,{children:`whoami`}),` succeeds.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Skill`}),_jsxs(_components.td,{children:[`The `,_jsx(_components.code,{children:`Attio`}),` MCP prompt is readable and routes the agent through discovery, the read route, and the undo limits.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`If any row fails, Attio is `,_jsx(_components.strong,{children:`partially ready`}),`. A saved OAuth record by itself\nis not a fully ready connection.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Unavailable to this account:`}),` check that you are signed in to the intended ApexGenius account and refresh Connections.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reconnect required:`}),` use the connection page to renew the saved authorization.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`A record or tool is missing:`}),` check the Attio user’s permissions and the tool settings for your AI agent. Do not expand access just to make a test pass.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SQL failed:`}),` `,_jsx(_components.code,{children:`query-particle-sql`}),` is not on every Attio plan. Ask for the same numbers with `,_jsx(_components.code,{children:`run-basic-report`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Rate limited:`}),` Attio limits calls per workspace. Semantic search, reports and SQL allow two calls a second. Space out bulk work.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Tool disabled:`}),` the owner has turned the tool off. Review tool access on the connection page.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://www.apexgenius.ai/connectors/attio`,children:`Explore the Attio connector`}),` · `,_jsx(_components.a,{href:`https://www.apexgenius.ai/connections/attio`,children:`Open Attio Connections`})]})]})}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":"Attio MCP Setup","description":"Connect an Attio workspace to ApexGenius through Attio's official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.","href":"/integrations/attio"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you need","slug":"what-you-need","depth":2,"children":[]},{"title":"Tools and the Attio skill","slug":"tools-and-the-attio-skill","depth":2,"children":[]},{"title":"What cannot be undone","slug":"what-cannot-be-undone","depth":2,"children":[]},{"title":"Connector, tools, and skill","slug":"connector-tools-and-skill","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"apexgenius","siteName":"ApexGenius","title":"Attio MCP Setup - ApexGenius","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T12:31:35.005Z","gitLastModified":"2026-11-05T12:27:26.000Z","originalFileLocation":"integrations/attio.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 an Attio workspace to ApexGenius through Attio\u0026#x27;s official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.\">\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=\"Attio MCP Setup - ApexGenius\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect an Attio workspace to ApexGenius through Attio\u0026#x27;s official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ApexGenius\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apexgenius.ai/integrations/attio\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apexgenius.mintlify.site/_mintlify/api/og/v2?division=Additional+connector+guides\u0026amp;title=Attio+MCP+Setup\u0026amp;description=Connect+an+Attio+workspace+to+ApexGenius+through+Attio%27s+official+hosted+MCP%2C+read+your+CRM+from+your+AI%2C+and+create+or+update+records%2C+notes+and+tasks.\u0026amp;theme=e9cacdcddfe6260e9743e25e\u0026amp;signature=275a1cb9f84a89dcf5271daae728bb88cb7cdd8291e3b5f4b664800be7695bd9\">\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=\"Attio MCP Setup - ApexGenius\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect an Attio workspace to ApexGenius through Attio\u0026#x27;s official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apexgenius.mintlify.site/_mintlify/api/og/v2?division=Additional+connector+guides\u0026amp;title=Attio+MCP+Setup\u0026amp;description=Connect+an+Attio+workspace+to+ApexGenius+through+Attio%27s+official+hosted+MCP%2C+read+your+CRM+from+your+AI%2C+and+create+or+update+records%2C+notes+and+tasks.\u0026amp;theme=e9cacdcddfe6260e9743e25e\u0026amp;signature=275a1cb9f84a89dcf5271daae728bb88cb7cdd8291e3b5f4b664800be7695bd9\">\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/attio\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/attio.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/attio#webpage\",\"url\":\"https://docs.apexgenius.ai/integrations/attio\",\"name\":\"Attio MCP Setup\",\"description\":\"Connect an Attio workspace to ApexGenius through Attio's official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.\",\"dateModified\":\"2026-11-05T12:27:26.000Z\",\"isPartOf\":{\"@id\":\"https://docs.apexgenius.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apexgenius.ai/integrations/attio#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apexgenius.ai/integrations/attio#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\":\"Attio MCP Setup\",\"item\":\"https://docs.apexgenius.ai/integrations/attio\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.apexgenius.ai/integrations/attio#article\",\"headline\":\"Attio MCP Setup\",\"name\":\"Attio MCP Setup\",\"description\":\"Connect an Attio workspace to ApexGenius through Attio's official hosted MCP, read your CRM from your AI, and create or update records, notes and tasks.\",\"url\":\"https://docs.apexgenius.ai/integrations/attio\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apexgenius.ai/integrations/attio#webpage\"},\"dateModified\":\"2026-11-05T12:27:26.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\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"ApexGenius\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/attio.md","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","description":"Authorize a Linear workspace through Linear's official hosted MCP, then read issues, projects and cycles and create or update work from your AI.","href":"/integrations/linear"},{"title":"Attio MCP Setup","href":"/integrations/attio"},{"title":"Calendly MCP Setup","description":"Connect Calendly to ApexGenius through Calendly's hosted MCP, read meetings, invitees and open times from your AI, and book or cancel meetings.","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","href":"/integrations/typesafe"},{"title":"HubSpot MCP Setup","href":"/integrations/hubspot"}]},{"title":"Connect Speedrun Alpha","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"}]}]},"basePath":"","title":"Attio MCP Setup - ApexGenius","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}