
โ labsco summary โ our analysis, not the vendor's
What it is โ An MCP server that connects the Attio AI-native CRM to MCP clients like Claude.
What you get โ
- Read company records straight from your Attio workspace โ e.g. "pull up the record for Acme Corp"
- Read company notes attached to a record
- Write new company notes back into Attio
- Runs over the Attio API via a bearer token
Requirements โ An Attio account and an ATTIO_API_KEY bearer token, obtained from Attio's API Explorer or via OAuth.
Cost snapshot โ The server is free and BSD-3-Clause licensed. It fronts your existing Attio subscription; Attio's own plan terms apply.
Setup effort โ npx attio-mcp-server with the key in your Claude Desktop config; a dotenv-based dev setup is documented for contributors.
Our take โ A reasonable starting point if you want an agent to reference CRM context, but the README's capability checklist is honest that it's early: only reading company records/notes and writing notes work today, while "other activities" remain unchecked โ no people, deals, or task support yet.
Source: the project README โ summarized 2026-07-08.
โ readme from github โ mirrored (latest on GitHub โ)
attio-mcp-server
This is an MCP server for Attio, the AI-native CRM. It allows mcp clients (like Claude) to connect to the Attio API.
Current Capabilities
- reading company records
- reading company notes
- writing company notes
- other activities
Development
Prerequisites
Before you begin, ensure you have the following installed:
- Node.js (recommended v22 or higher)
- npm
- git
- dotenv
Setting up Development Environment
To set up the development environment, follow these steps:
-
Fork the repository
- Click the "Fork" button in the top-right corner of this repository
- This creates your own copy of the repository under your Github acocunt
-
Clone Your Fork:
git clone https://github.com/YOUR_USERNAME/attio-mcp-server.git cd attio-mcp-server -
Add Upstream Remote
git remote add upstream https://github.com/hmk/attio-mcp-server.git -
Copy the dotenv file
cp .env.template .env -
Install dependencies:
npm install -
Run watch to keep index.js updated:
npm run build:watch -
Start the model context protocol development server:
dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js -
If the development server did not load the environment variable correctly, set the
ATTIO_API_KEYon the left-hand side of the mcp inspector.
{
"mcpServers": {
"attio": {
"command": "npx",
"args": ["attio-mcp-server"],
"env": {
"ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
}
}
}
}Before it works, you'll need: ATTIO_API_KEY
Usage
You will need:
ATTIO_API_KEY
This is expected to be a bearer token which means you can get one through the API Explorer on the right hand side or configure OAuth and retrieve one throught the Attio API.
Claude Desktop Configuration
{
"mcpServers": {
"attio": {
"command": "npx",
"args": ["attio-mcp-server"],
"env": {
"ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
}
}
}
}No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under BSD-3-Clauseโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ