attio-cli

CLI for the Attio CRM API. Built for scripts, agents, and humans who prefer terminals.

Install

npm install -g attio-cli

Quick Start

attio init          # guided setup — paste your API key, done
attio whoami        # verify connection
attio people list --limit 5

You'll need an API key from Attio Developer Settings. attio init walks you through the rest.

Examples

# List companies, filter by name
attio companies list --filter 'name~Acme'

# Search for a person
attio people search "Jane"

# Create a company and get back just the ID
attio companies create --set name="Acme" --set domains='["acme.com"]' -q

# Get a record as JSON and pipe to jq
attio companies list --json | jq '.[].values.name[0].value'

# Export all companies to CSV
attio companies list --all --csv > companies.csv

See Scripting Examples for more advanced workflows (bulk updates, chaining commands, etc.).

For non-interactive environments (CI, scripts), use any of:

attio init --api-key <key>           # validates and saves
export ATTIO_API_KEY=<key>           # env var (takes precedence)
attio config set api-key <key>       # direct config write

Agent Setup

To let AI agents (Claude, etc.) discover this CLI, append the auto-generated snippet to your project's CLAUDE.md:

attio config claude-md >> CLAUDE.md

Command Reference

Command	Description
attio init	Interactive setup wizard — connect to your Attio workspace
attio whoami	Show current workspace and user info
Objects
attio objects list	List all objects in the workspace
attio objects get <slug>	Get details for a specific object
Attributes
attio attributes list <object>	List attributes for an object
Records
attio records list <object>	List records for an object
attio records get <object> <id>	Get a specific record
attio records create <object>	Create a new record
attio records update <object> <id>	Update an existing record
attio records delete <object> <id>	Delete a record
attio records assert <object>	Create or update a record by matching attribute
attio records upsert <object>	Alias for records assert
attio records search <query>	Full-text search across one or more objects
attio records values <object> <id>	List current and historic attribute values
attio records entries <object> <id>	List list entries where this record is the parent
People
attio people list	List people
attio people get <id>	Get a person by ID
attio people create	Create a person
attio people update <id>	Update a person
attio people delete <id>	Delete a person
attio people assert	Assert (upsert) a person by matching attribute
attio people search <query>	Search people by name or email
Companies
attio companies list	List companies
attio companies get <id>	Get a company by ID
attio companies create	Create a company
attio companies update <id>	Update a company
attio companies delete <id>	Delete a company
attio companies assert	Assert (upsert) a company by matching attribute
attio companies search <query>	Search companies by name or domain
Deals
attio deals list	List deals
attio deals get <id>	Get a deal by ID
attio deals create	Create a deal
attio deals update <id>	Update a deal
attio deals delete <id>	Delete a deal
attio deals assert	Assert (upsert) a deal by matching attribute
attio deals search <query>	Search deals
Users
attio users list	List users
attio users get <id>	Get a user by ID
attio users create	Create a user
attio users update <id>	Update a user
attio users delete <id>	Delete a user
attio users assert	Assert (upsert) a user by matching attribute
attio users search <query>	Search users
Workspaces (Standard Object)
attio workspaces list	List workspace records
attio workspaces get <id>	Get a workspace record by ID
attio workspaces create	Create a workspace record
attio workspaces update <id>	Update a workspace record
attio workspaces delete <id>	Delete a workspace record
attio workspaces assert	Assert (upsert) a workspace record by matching attribute
attio workspaces search <query>	Search workspace records
Lists
attio lists list	List all lists
attio lists get <id>	Get a specific list
Entries
attio entries list <list>	List entries in a list
attio entries get <list> <id>	Get a specific entry
attio entries create <list>	Add an entry to a list
attio entries assert <list>	Assert (upsert) an entry by parent record
attio entries update <list> <id>	Update a list entry
attio entries delete <list> <id>	Remove an entry from a list
Tasks
attio tasks list	List tasks
attio tasks get <id>	Get a specific task
attio tasks create	Create a task
attio tasks update <id>	Update a task
attio tasks delete <id>	Delete a task
Notes
attio notes list	List notes
attio notes get <id>	Get a specific note
attio notes create	Create a note
attio notes delete <id>	Delete a note
Comments
attio comments list	List comments on a thread
attio comments create	Create a comment
attio comments delete <id>	Delete a comment
Threads
attio threads list	List threaded conversations
attio threads get <id>	Get a thread by ID
Meetings (Beta)
attio meetings list	List meetings (beta endpoint)
attio meetings get <id>	Get a meeting (beta endpoint)
Recordings (Beta)
attio recordings list --meeting <id>	List call recordings for a meeting
attio recordings get <id> --meeting <id>	Get a call recording, optionally with transcript
Webhooks
attio webhooks events	List supported webhook event types
attio webhooks list	List webhooks
attio webhooks get <id>	Get a webhook by ID
attio webhooks create	Create a webhook
attio webhooks update <id>	Update a webhook
attio webhooks delete <id>	Delete a webhook
Members
attio members list	List workspace members
Config
attio config set <key> <value>	Set a config value
attio config get <key>	Get a config value
attio config path	Print the config file path
Open
attio open	Open the Attio web app in your browser

Global Flags

Flag	Description
--api-key <key>	Override the API key for this request
--json	Force JSON output
--table	Force table output
--csv	Force CSV output
-q, --quiet	Only output IDs (one per line)
--no-color	Disable colored output
--debug	Print request/response details to stderr

Output format is auto-detected: table when stdout is a TTY (interactive terminal), JSON when piped.

Filtering

Use --filter to narrow results. The syntax is attribute operator value.

Operator	Meaning	Example
=	Equals	--filter 'name=Acme'
!=	Not equals	--filter 'status!=closed'
~	Contains	--filter 'name~corp'
!~	Does not contain	--filter 'name!~test'
^	Starts with	--filter 'name^Acme'
>	Greater than	--filter 'revenue>1000000'
>=	Greater than or equal	--filter 'created_at>=2024-01-01'
<	Less than	--filter 'revenue<500000'
<=	Less than or equal	--filter 'created_at<=2024-12-31'
?	Is set / not empty	--filter 'email?'

Multiple filters are ANDed together:

attio records list companies --filter 'name~Acme' --filter 'revenue>=1000000'

Sorting

Use --sort with the format attribute:direction:

attio records list companies --sort name:asc
attio people list --sort name.last_name:desc

Scripting Examples

# Create a company and immediately add a note
ID=$(attio records create companies --set name="Acme" --set domains='["acme.com"]' -q)
attio notes create --object companies --record $ID --title "New lead" --content "From website"

# Export all companies to JSON
attio records list companies --all --json > companies.json

# Pipe to jq
attio records list companies --all --json | jq -r '.[].values.name[0].value'

# Bulk update from a CSV
while IFS=, read -r id status; do
  attio records update companies "$id" --set "status=$status"
done < updates.csv

# Find and delete test records
attio records list companies --filter 'name^TEST_' --json -q | \
  xargs -I{} attio records delete companies {}

Why CLI over MCP for Agents

While MCP tools work well, a CLI is often the better choice for AI agent workflows:

• Simpler — a single bash command vs. structured tool-call JSON
• Self-documenting — attio --help and attio companies --help let agents discover capabilities without external docs
• LLM-native — language models are heavily RL'd on command-line usage; they generate CLI invocations more reliably than tool-call schemas
• Composable — pipe attio output into jq, grep, xargs, or any other Unix tool, building complex workflows from simple parts
• Cheaper — MCP servers load all tool schemas as input tokens on every LLM call (14,521 tokens for Attio's 30 tools), even if only one tool is used. A CLI just needs the Bash tool schema (~200 tokens). See benchmarks/REPORT.md for detailed cost comparisons.

Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/my-feature)
3. Make your changes
4. Run tests (npm test)
5. Submit a pull request

License

MIT -- see LICENSE for details.