Know where every deal stands without opening Attio. Ask Claude, ChatGPT, Codex or any AI agent, and it answers from a copy of your Attio deals on your computer, even offline.
Docs · Install · Usage · Discord
- Ask instead of clicking. "Which deals are stuck in Negotiation?" gets an answer in a second, in Claude Code, Codex, Claude Desktop or any app that speaks MCP.
- Your pipeline, offline. Deals, stages and what changed since yesterday are read from your computer, with no request to Attio.
- Safe to hand to an agent. The deal commands only read, and one line keeps every write in the Attio API away from an agent.
- The answer, not the search. Ask about a deal in your own words. The agent finds it with its stage, amount, company and people.
- The pipeline at a glance. How many deals stand in each stage, their total per currency, and your win rate.
- What changed overnight. Deals created, moved, won and lost, as a list or a short morning digest.
- People and companies on demand. Read live from Attio, with e-mails and phones, when you ask.
- Attio deals export. Any list of deals, people or companies becomes a CSV file for a spreadsheet.
You: Which deals are in Negotiation?
Agent: (runs attio work deals list stage:Negotiation status:open)
· "Example LLC renewal", 24 000 USD, owner Anna Example
· "Sample Inc pilot", 6 500 USD, owner Bob Sample
You: What did we win this week?
Agent: (runs attio work changes list change:won "at>=7d")
One deal: "Example Corp expansion", 12 000 USD, won on Tuesday.
Invented deals, illustrative output.
- A copy of your CRM on your computer.
synccopies your deals, people and companies into a local store. Lists, the pipeline board and search answer from it with no request to Attio, also offline. - A permission on every action. Each command and each Attio API operation has its own level: allow, ask, read
only or deny.
WCATTIO_READ_ONLY=1stops every write. - The token stays in your system keyring. It never appears in output, errors or run records, and is never taken as an argument.
- Your CRM beside your other context. Deals sit in the same local store as your messages, mail, notes and meetings from the other WireCat tools, so one search covers all of them.
- The whole Attio API too. Every operation is a command with its own help, for what has no command of its own yet: notes, tasks, lists, custom objects.
- Free and open source. Apache 2.0.
In WireCat Desktop, add Attio from the tool list and paste the access token when it asks. Or in a terminal:
npm install -g @wirecat/attio-cli
attio skill install # the agent skill, for Claude Code, Codex, Gemini CLI and OpenClaw
attio work session start # paste your Attio access token
attio work sync # copy your deals, people and companies
attio work deals list status:openwork is a profile, a name you choose for one Attio workspace. It is the first word of every command that uses an
account, and none is ever assumed.
The access token. In Attio, open Workspace settings → Developers → New access token. Give it read access to
record_permission, object_configuration and user_management, and copy it. Only a workspace admin can make one.
session start asks for it without showing it, checks it with Attio and keeps it in the system keyring.
You need Node.js 22.16 or a later 22.x, or Node.js 24 or later. attio doctor needs no network and shows what is set
up.
More: installation and sign-in, step by step
Ask in plain words. The agent picks the commands.
"Use attio. What changed in our pipeline since yesterday?" "Use attio. How many deals did we win in the last 30 days, and what is our win rate?" "Use attio. Who is our contact at Example LLC, and what deals do we have open with them?"
- Claude Code, Codex, Gemini CLI and other agents with a terminal run
attiothemselves.attio skill installteaches them how. - Claude Desktop, Cursor and other MCP apps connect to the Attio MCP server,
attio work mcp serve. - ChatGPT or Claude in the browser reach it through your own tunnel, after a login with a one-time code.
attio work config set permissions.api readonly # no writes through the Attio API on this profile
attio work mcp add claude-code --allow-writes # or: codex
attio work mcp config # the entry for Claude Desktop, Cursor and othersOver MCP nobody is at a terminal to answer a question, so a write set to ask goes ahead. The first line above keeps
every write away from the agent.
More: agents and MCP · permissions
attio work deals list status:open
attio work deals list stage:"In Progress"
attio work deals show deal:12 # one deal with its company and people
attio work deals list status:open --format csv > deals.csvWon is the stage Attio celebrates, and lost is a stage whose title starts with "Lost".
attio work pipelines show # each stage: how many, their sum, how many went on
attio work pipelines show --since-time 30d # the deals made in the last 30 days, with the win rateattio work changes list "at>=1d" # deals created, moved, won and lost
attio work changes list "at>=1d" --format report # the same as a short morning digestattio work people list anna # search Attio by name or e-mail
attio work organizations list example # companies by name
attio work users list # your workspace membersThese read Attio itself, so they need the network.
attio work fields list deals # the attributes your workspace added, with their type
attio work search all "Example LLC" # deals next to your messages, notes and meetingsattio work api list # every operation, without calling Attio
attio work api objects-list # the objects in your workspaceMore: using attio · every command
- An access token. A workspace admin makes it in Attio. It is kept in the system keyring, or in a private file on a computer without one.
- A local copy.
synccopies the workspace's deals, people and companies, with the stages of Attio's deal pipeline, into the WireCat local store. Attio cannot list only what changed, so each sync reads every record. - Live where it matters.
people,organizationsandusersask Attio each time, so they show the newest data. - Made for scripts.
--jsonprints one JSON value for every command, and an error comes as JSON with a code to branch on.
Each profile has a level for every command and every Attio API operation: allow, ask, readonly or deny. A
delete through the API asks first at a terminal.
attio work config set permissions.api readonly # the Attio API reads, never writes
attio work config show # each setting and where it came fromMore: permissions · settings
- The deal commands read. Moving or closing a deal from
attiois on the roadmap, and so are notes, tasks, custom objects, lists and a one-click sign-in. - Only a workspace admin can make the token, and it reads the whole workspace.
- Attio documents 100 reads and 25 writes a second (rate limits).
- Before 1.0, a minor version may change commands,
--jsonfields and MCP tools. The changelog lists each such change under "may break callers".
The token reads your whole workspace, so attio keeps it in the system keyring and never prints it, in output,
errors or run records. It talks only to api.attio.com. Text from Attio is marked as untrusted, so an agent reads a
deal title as data, not as an instruction.
More: security · Report a vulnerability: SECURITY.md
attio doctor # what is set up, without connecting
attio work session status --check # asks Attio which workspace the token belongs toMore: troubleshooting · Ask on Discord · Bugs go to this repository's issues.
Everything is in docs/: installation, usage, MCP, permissions, settings, the command reference and the roadmap.
You need Node.js 22.16 or a later 22.x, or Node.js 24 or later, and pnpm.
pnpm install && pnpm testTests use a fake Attio built from Attio's API description, with invented records, and nothing reaches a real
workspace. The CLI is described in one file, wirecat.config.ts, and started from
cli-template.
More: design · working rules
Pull requests, bug reports and ideas go to issues.
attio is one of the WireCat tools: open-source, local-first command-line tools that give AI
agents your context from messengers, mail, calendars, CRMs and documents. Each one works on its own.