attio-automation
π―SkillInstallation
npx skills add composiohq/awesome-claude-skills --skill attio-automationRun it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).
Uses skills.sh Β· Node.js 22.20+
After installing
Ask for related work and the agent uses it on its own, or call it yourself.
/Attio AutomationInstall by hand
Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.
Open the skill folder β- This project
.claude/skills/attio-automation/ - All projects
~/.claude/skills/attio-automation/
These paths are for Claude Code. For other tools, the command above puts it in the right place.
SKILL.md
View on GitHub βAutomate Attio CRM operations -- search records, query contacts and companies with advanced filters, manage notes, list attributes, and navigate your relationship data -- using natural language through the Composio MCP integration.
Attio Automation
Manage your Attio CRM workspace -- fuzzy search across people and companies, run complex filtered queries, browse notes, discover object schemas, and list records -- all through natural language commands.
Toolkit docs: composio.dev/toolkits/attio
Setup
- Add the Composio MCP server to your client configuration:
https://rube.app/mcp - Connect your Attio account when prompted (OAuth authentication).
- Start issuing natural language commands to manage your CRM data.
Core Workflows
1. Fuzzy Search Across Records
Search for people, companies, deals, or any object by name, domain, email, phone, or social handle.
Tool: ATTIO_SEARCH_RECORDS
Example prompt:
"Search Attio for anyone named Alan Mathis"
Key parameters (all required):
query-- Search string (max 256 characters). Empty string returns default results.objects-- Array of object slugs to search (e.g.,["people"],["people", "companies"],["deals"])request_as-- Context: use{"type": "workspace"}for full workspace search, or specify a workspace member
2. Advanced Filtered Queries
Query records with server-side filtering, sorting, and complex conditions -- far more powerful than fuzzy search.
Tool: ATTIO_QUERY_RECORDS
Example prompt:
"Find all companies in Attio created after January 2025 sorted by name"
Key parameters:
object(required) -- Object slug or UUID (e.g., "people", "companies", "deals")filter-- Attio filter object with operators like$eq,$contains,$gte,$and,$orsorts-- Array of sort specifications withdirection("asc"/"desc") andattributelimit-- Max records to return (up to 500)offset-- Pagination offset
Filter examples:
{"name": {"first_name": {"$contains": "John"}}}
{"email_addresses": {"$contains": "@example.com"}}
{"created_at": {"$gte": "2025-01-01T00:00:00.000Z"}}
3. Find Records by ID or Attributes
Look up a specific record by its unique ID or search by unique attribute values.
Tool: ATTIO_FIND_RECORD
Example prompt:
"Find the Attio company with domain example.com"
Key parameters:
object_id(required) -- Object type slug: "people", "companies", "deals", "users", "workspaces"record_id-- Direct lookup by UUID (optional)attributes-- Dictionary of attribute filters (e.g.,{"email_addresses": "john@example.com"})limit-- Max records (up to 1000)offset-- Pagination offset
4. Browse and Filter Notes
List notes across the workspace or filter by specific parent objects and records.
Tool: ATTIO_LIST_NOTES
Example prompt:
"Show the last 10 notes on the Acme Corp company record in Attio"
Key parameters:
parent_object-- Object slug (e.g., "people", "companies", "deals") -- requiresparent_record_idparent_record_id-- UUID of the parent record -- requiresparent_objectlimit-- Max notes to return (1-50, default 10)offset-- Number of results to skip
5. Discover Object Schemas and Attributes
Understand your workspace structure by listing objects and their attribute definitions.
Tools: ATTIO_GET_OBJECT, ATTIO_LIST_ATTRIBUTES
Example prompt:
"What attributes does the companies object have in Attio?"
Key parameters for Get Object:
object_id-- Object slug or UUID
Key parameters for List Attributes:
target-- "objects" or "lists"identifier-- Object or list ID/slug
6. List All Records
Retrieve records from a specific object type with simple pagination, returned in creation order.
Tool: ATTIO_LIST_RECORDS
Example prompt:
"List the first 100 people records in Attio"
Key parameters:
- Object type identifier
- Pagination parameters
Known Pitfalls
- Timestamp format is critical: ALL timestamp comparisons (
created_at,updated_at, custom timestamps) MUST use ISO8601 string format (e.g.,2025-01-01T00:00:00.000Z). Unix timestamps or numeric values cause "Invalid timestamp value" errors. - Name attributes must be nested: The
nameattribute has sub-properties (first_name,last_name,full_name) that MUST be nested undername. Correct:{"name": {"first_name": {"$contains": "John"}}}. Wrong:{"first_name": {...}}-- this fails with "unknown_filter_attribute_slug". - Email operators are limited:
email_addressessupports$eq,$contains,$starts_with,$ends_withbut NOT$not_empty. - Record-reference attributes need path filtering: For attributes that reference other records (e.g., "team", "company"), use path-based filtering, not nested syntax. Example:
{"path": [["companies", "team"], ["people", "name"]], "constraints": {"first_name": {"$eq": "John"}}}. - "lists" is not an object type: Do not use "lists" as an
object_id. Use list-specific actions for list operations. - Search is eventually consistent:
ATTIO_SEARCH_RECORDSreturns eventually consistent results. For guaranteed up-to-date results, useATTIO_QUERY_RECORDSinstead. - Attribute slugs vary by workspace: System attributes (e.g., "email_addresses", "name") are consistent, but custom attributes vary. Use
ATTIO_LIST_ATTRIBUTESto discover valid slugs for your workspace.
Quick Reference
| Action | Tool Slug | Required Params |
|---|---|---|
| Fuzzy search records | ATTIO_SEARCH_RECORDS | query, objects, request_as |
| Query with filters | ATTIO_QUERY_RECORDS | object |
| Find record by ID/attributes | ATTIO_FIND_RECORD | object_id |
| List notes | ATTIO_LIST_NOTES | None (optional filters) |
| Get object schema | ATTIO_GET_OBJECT | object_id |
| List attributes | ATTIO_LIST_ATTRIBUTES | target, identifier |
| List records | ATTIO_LIST_RECORDS | Object type |
Powered by Composio
More from this repository10
A Claude Code plugin that analyzes meeting notes and transcripts to extract key insights, action items, and decisions using Composio app integrations.
A Claude Code plugin from the Awesome Claude Skills collection that downloads videos from YouTube and other platforms for offline viewing, editing, or archival, with support for various formats and quality options.
A Claude Code plugin that assists in writing high-quality content by conducting research, adding citations, improving hooks, and providing section-by-section feedback.
A Claude Code plugin that automatically organizes and categorizes files in your workspace using Composio integrations, helping maintain a clean project structure.
A Claude Code plugin providing tools for creating elaborate, multi-component HTML artifacts using React, Tailwind CSS, and shadcn/ui in claude.ai.
A Claude Code skill that randomly selects winners from participant lists, spreadsheets, or Google Sheets for giveaways and contests using cryptographically secure randomness.
A Claude Code plugin that automates Zoho CRM workflows including lead management, contact updates, deal tracking, account operations, and custom module interactions through Composio integration.
A Claude Code plugin that enforces brand consistency by checking code and content against your brand guidelines using Composio integrations.
A pre-built workflow skill for automating Help Scout via Composio, enabling Claude to manage conversations, customers, mailboxes, and tags through structured tool sequences and parameter guidance.
A Claude Code plugin that automatically creates user-facing changelogs from git commits by analyzing commit history and transforming technical commits into customer-friendly release notes.