Attio — Claude Code MCP server: what it does, how to install
A hosted MCP endpoint that gives your agent Attio records, lists, tasks, notes, emails and call transcripts.
no license 242 installs updated 2025-11-19
claude mcp add --transport http attio https://attio.run.toolsWhat Attio does
Attio is where the team keeps its people and company records, notes and tasks. This server puts that workspace in front of a coding agent, so it can read the data and write back without you copying anything by hand.
It talks over HTTP at https://attio.run.tools; nothing runs on your machine. The toolset covers records (create-record, list-records, search-records, get-records-by-ids), lists and their attribute definitions, tasks, notes and comments. A second group reaches communication: emails and meetings by metadata, semantic search over emails, notes and call transcripts, and run-basic-report for counts, totals and grouped breakdowns.
Order matters for writes. create-record expects a list-attribute-definitions call first, because that is where field types, required flags and select options come from; add-record-to-list wants the list definitions plus a record you already found. Email search only returns messages your user can see.
What it helps with
- look up a company by domain and read its fields
- create a record with the required attributes filled in
- total a metric across list entries
- find a call about a topic without knowing the wording
- assign a task with a deadline to a workspace member
Example prompts for the agent
- Find every Attio company on the
acme.comdomain and summarize the notes on each record. - Create a task for Friday, assign it to a workspace member, and link it to that person record.
- Search the call transcripts by meaning for the pricing discussion.
How to install Attio
Platform CLI: remote server
claude mcp add --transport http attio https://attio.run.toolsPlatform CLI: remote server
codex mcp add attio --url https://attio.run.toolsConfig file
{
"mcpServers": {
"attio": {
"url": "https://attio.run.tools"
}
}
}Config file
{
"servers": {
"attio": {
"type": "http",
"url": "https://attio.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http attio https://attio.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Attio
How do I install Attio in Claude Code?
Run claude mcp add --transport http attio https://attio.run.tools. That registers the hosted endpoint over the http transport.
What does the Attio MCP server do?
It exposes your Attio workspace to an agent: records, lists, tasks, notes and comments, plus emails, meetings and call transcripts with search over each.
What is the difference between search-records and semantic-search-notes?
search-records matches indexed record fields such as domains, email addresses, phone numbers, names and descriptions. semantic-search-notes goes by meaning, so it can surface a note that never uses your keywords.