Attio MCP Server — Hosted Api Connectors Integration
MCP Server language Hosted language PublicManage people, companies, deals, notes, and tasks in Attio CRM — full workspace automation for modern revenue teams.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"attio": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-attio",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the list_people tool to list people records in attio with cursor-based pagination. returns record ids, names, emails, and phone numbers”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-attio — Attio CRM MCP Server
Automate your entire Attio workspace — manage people, companies, deals, notes, tasks, and workspace members from any AI agent.
Attio is a modern, data-driven CRM built for high-growth B2B teams. This MCP server gives your agents complete access to the Attio REST API: listing and creating records across people, companies, and deals; searching with rich filters; logging notes and tasks on any record; and introspecting workspace membership.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-attio
What You Can Do
- Enrich and sync people and company records from external data sources automatically
- Create and progress deals through pipeline stages based on external signals (signed contracts, payments, emails)
- Log call summaries and meeting notes directly to CRM records without opening Attio
- Assign tasks to workspace members and track completion via AI-driven workflows
- Search and filter across people, companies, and deals using Attio's native filter syntax
Available Tools
| Tool | Description |
|---|---|
| list_people | List people records with cursor-based pagination |
| get_person | Get a person record by record_id |
| create_person | Create a person with name, email, and phone |
| update_person | Update person attributes |
| delete_person | Delete a person record |
| list_companies | List company records with cursor-based pagination |
| get_company | Get a company record by record_id |
| create_company | Create a company with name, domains, and employee range |
| update_company | Update company attributes |
| delete_company | Delete a company record |
| list_deals | List deal records with cursor-based pagination |
| get_deal | Get a deal record by record_id |
| create_deal | Create a deal with name, stage, and monetary value |
| update_deal | Update deal stage, value, or close date |
| delete_deal | Delete a deal record |
| search_records | Search people, companies, or deals using Attio filter syntax |
| list_record_entries | List all timeline entries on a record |
| create_note | Create a note attached to any record |
| list_notes | List notes for a specific record |
| list_tasks | List tasks, optionally filtered by record or completion status |
| create_task | Create a task linked to people, companies, or deals |
| list_workspace_members | List all members in the workspace |
| _ping | Verify connectivity — calls GET /v2/self |
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
| ATTIO_ACCESS_TOKEN | Yes | Attio API Bearer token | Attio Workspace Settings → API → Access tokens → Create token with required scopes |
Required Token Scopes
Your access token needs read/write scopes for the objects you intend to manage:
- Records —
record:read,record:write - Notes —
note:read,note:write - Tasks —
task:read,task:write - Workspace members —
workspace_member:read
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Attio" and click Add to Workspace
- Add your
ATTIO_ACCESS_TOKENunder Project → Secrets
Once added, every AI agent in your workspace can manage Attio CRM data automatically — no per-user setup needed.
Example Prompts
"Find all people at Acme Corp in Attio and list their email addresses"
"Create a new deal for Acme Corp in the Qualification stage worth $75,000"
"Move deal rec_deal_001 to Closed Won and log a note saying the contract was signed"
"List all incomplete tasks assigned to workspace members due this week"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-attio \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-ATTIO-ACCESS-TOKEN: your-token' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_records","arguments":{"object_slug":"people","filter":{"name":{"$str_contains":"Jane"}},"limit":10}}}'
License
MIT
terminal Tools (23)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
list_people #1 List people records in Attio with cursor-based pagination. Returns record IDs, names, emails, and phone numbers.
get_person #2 Get a person record by record_id. Returns attributes: name, email_addresses, phone_numbers, company.
create_person #3 Create a new person record in Attio. Provide name, email_addresses, and/or phone_numbers.
update_person #4 Update attributes on an existing person record. Provide only the fields to change.
delete_person #5 Delete a person record from Attio by record_id.
list_companies #6 List company records in Attio with cursor-based pagination. Returns name, domains, and basic attributes.
get_company #7 Get a company record by record_id. Returns name, domains, description, and employee_count.
create_company #8 Create a new company record in Attio. Provide name, domains, description, and/or employee_range.
update_company #9 Update attributes on an existing company record. Provide only the fields to change.
delete_company #10 Delete a company record from Attio by record_id.
list_deals #11 List deal records in Attio with cursor-based pagination. Returns name, stage, value, and associations.
get_deal #12 Get a deal record by record_id. Returns name, stage, value, associated_people, and associated_companies.
create_deal #13 Create a new deal record in Attio. Provide name, stage, and optionally a monetary value.
update_deal #14 Update fields on an existing deal (stage, value, close_date). Provide only the fields to change.
delete_deal #15 Delete a deal record from Attio by record_id.
search_records #16 Search records across an Attio object using a filter query. Supports people, companies, and deals.
list_record_entries #17 List all entries (timeline activity) on a record. Returns interactions, notes, and task entries.
create_note #18 Create a note entry on an Attio record. Notes are attached to the record timeline.
list_notes #19 List notes for a specific Attio record.
list_tasks #20 List tasks in Attio workspace. Optionally filter by linked record or completion status.
create_task #21 Create a task in Attio. Tasks can be linked to people, companies, or deal records.
list_workspace_members #22 List all members in the current Attio workspace with their IDs, names, and email addresses.
_ping #23 Verify connectivity and authentication. Calls GET /v2/self and returns current user/workspace info.
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-attio
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in API Connectors
Browse API Connectors MCPs →Aerostack Registry
by @aerostack
Discover and invoke any MCP, Function, or Skill published to the Aerostack marketplace — the universal AI capability hub.
Algolia
by @aerostack
Search indexes, manage records, browse data, and configure ranking in Algolia — AI-native instant search access.
Arangodb
by @aerostack
Query documents, run AQL, traverse graphs, and manage collections in your ArangoDB database — AI-native multi-model database access.
Ayrshare
by @aerostack
Post, schedule, and analyze social media across 13 platforms — Facebook, Instagram, X, LinkedIn, TikTok, Bluesky, Threads, Reddit, Pinterest, YouTube, Telegram, Snapchat, Google Business.
Basecamp
by @aerostack
Manage projects, to-dos, messages, schedules, and campfire chats in Basecamp — AI-native project management.
Bigquery
by @aerostack
Run SQL queries, list datasets and tables, inspect schemas, and export results from Google BigQuery — AI-native data warehouse access.
Frequently asked questions
What is the Attio MCP server and what can it do? +
The Attio MCP server is hosted on Aerostack and exposes these tools to your AI agent: `list_people`, `get_person`, `create_person`, `update_person`, `delete_person`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Attio MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Attio MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Attio MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Attio MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-attio": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-attio"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Attio MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-attio", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-attio"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Attio MCP require authentication? +
Yes. Attio requires authentication. Check the MCP's documentation for the required credentials.