Attio CRM CLI

attio-cli

Interact with your Attio CRM workspace via the attio-cli.

Install

1. Clone and install the CLI:

git clone https://github.com/FroeMic/attio-cli
cd attio-cli
npm install
npm link

2. Set ATTIO_API_KEY environment variable (get it from Attio Settings > Developers > API Keys): - Recommended: Add to ~/.claude/.env for Claude Code - Alternative: Add to ~/.bashrc or ~/.zshrc: export ATTIO_API_KEY="your-api-key"

Repository: https://github.com/FroeMic/attio-cli

Commands

List objects and records:

attio object list                      # List all objects
attio record list people               # List people records
attio record list companies            # List company records

Work with lists (pipelines):

attio list list-all                    # List all lists
attio entry list            # List entries in a list

Get detailed info:

attio object get          # Get object details
attio object attributes   # Get object attributes
attio list attributes       # Get list entry attributes

Generate Workspace Schema

Generate a markdown schema of your workspace for context:

bash {baseDir}/scripts/generate-schema.sh > {baseDir}/workspace.schema.md

This creates a reference file documenting all objects, attributes, lists, and field options in your workspace.

Key Concepts

| Concept | Purpose | Example | |---------|---------|---------| | Objects | Base record types | People, Companies, Deals | | Lists | Pipeline/workflow management | Sales Pipeline, Hiring | | Records | Individual items in objects | A specific person or company | | Entries | Records added to a list | A deal in the Sales Pipeline |

API Reference

Common API Operations

Search for a person:

curl -X POST https://api.attio.com/v2/objects/people/records/query \
  -H "Authorization: Bearer $ATTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter": {"email_addresses": {"contains": "john@example.com"}}}'

Create a record:

curl -X POST https://api.attio.com/v2/objects//records \
  -H "Authorization: Bearer $ATTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": {"values": {"name": [{"value": "Record Name"}]}}}'

Add entry to a list:

curl -X POST https://api.attio.com/v2/lists//entries \
  -H "Authorization: Bearer $ATTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": {"parent_record_id": ""}}'

Notes