How do I install the Attio CLI skill?

Run npx skillmds@latest add modbender/attio-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Attio CLI skill do?

Interact with your Attio CRM workspace via the attio-cli. It is listed under Coding & Dev Tools on SkillMD.

Is Attio CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Attio CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Attio CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Attio CLI?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Attio CLI by modbender — Agent Skill

Name: Attio CLI
Rating: 4.666666666666667 (3 reviews)
Author: modbender

File contents

attio-cli

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

Install

Clone and install the CLI:

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

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-slug>           # List entries in a list

Get detailed info:

attio object get <object-slug>         # Get object details
attio object attributes <object-slug>  # Get object attributes
attio list attributes <list-slug>      # 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

Base URL: https://api.attio.com/v2
Auth: Authorization: Bearer $ATTIO_API_KEY
Rate Limits: 100 requests per 10 seconds per workspace

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/<object-slug>/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/<list-slug>/entries \
  -H "Authorization: Bearer $ATTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"data": {"parent_record_id": "<record-id>"}}'

Notes

Run generate-schema.sh after installing to create a workspace schema file with all your objects, lists, and field options.
Lists are commonly used to manage pipelines (sales stages, hiring workflows, etc.).
The CLI requires jq for JSON processing in schema generation.

---name: attio-clidescription: Interact with your Attio CRM workspace via the attio-cli.--- # attio-cli Interact with your Attio CRM workspace via the attio-cli. ## Install 1. Clone and install the CLI: ```bash 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: ```bash attio object list # List all objects attio record list people # List people records attio record list companies # List company records ``` Work with lists (pipelines): ```bash attio list list-all # List all lists attio entry list <list-slug> # List entries in a list ``` Get detailed info: ```bash attio object get <object-slug> # Get object details attio object attributes <object-slug> # Get object attributes attio list attributes <list-slug> # Get list entry attributes ``` ## Generate Workspace Schema Generate a markdown schema of your workspace for context: ```bash 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 - **Base URL:** `https://api.attio.com/v2` - **Auth:** `Authorization: Bearer $ATTIO_API_KEY` - **Rate Limits:** 100 requests per 10 seconds per workspace ## Common API Operations Search for a person: ```bash 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: ```bash curl -X POST https://api.attio.com/v2/objects/<object-slug>/records \ -H "Authorization: Bearer $ATTIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"data": {"values": {"name": [{"value": "Record Name"}]}}}' ``` Add entry to a list: ```bash curl -X POST https://api.attio.com/v2/lists/<list-slug>/entries \ -H "Authorization: Bearer $ATTIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"data": {"parent_record_id": "<record-id>"}}' ``` ## Notes - Run `generate-schema.sh` after installing to create a workspace schema file with all your objects, lists, and field options. - Lists are commonly used to manage pipelines (sales stages, hiring workflows, etc.). - The CLI requires `jq` for JSON processing in schema generation.

Frequently asked questions

Attio CLI