Attio Simple MCP Server
An MCP (Model Context Protocol) server that integrates Attio CRM with AI clients like Claude Code, Claude Desktop, ChatGPT, Windsurf, and Cursor.
This template was created by Manoel Lemos as a shortcut for people interested in deploying Attio MCP servers.
Features
- 14 Tools for managing companies, people, and notes in Attio
- Schema Discovery - Dynamically discover your workspace's objects and attributes
- Type-Safe - Full TypeScript with auto-generated Attio API types
Available Tools
| Category | Tools |
|---|---|
| Schema | get_workspace_schema |
| Companies | search_companies, get_company, create_company, update_company, manage_company_domains |
| People | search_people, get_person, create_person, update_person, manage_person_emails, manage_person_tags |
| Notes | create_note, get_note |
Quick Start
1. Install Dependencies
npm install
2. Configure Environment
cp .env.example .env
Edit .env and add your Attio API key:
ATTIO_API_KEY="your_api_key_here"
ATTIO_WORKSPACE_SLUG="your-workspace-slug" # Optional: for web URLs
Get your API key from Attio Settings > Developers > API Keys.
3. Build
npm run build
4. Configure Your AI Client
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"attio": {
"command": "node",
"args": ["/absolute/path/to/attio-mcp/dist/index.js"],
"env": {
"ATTIO_API_KEY": "your_api_key_here",
"ATTIO_WORKSPACE_SLUG": "your-workspace-slug"
}
}
}
}
Claude Code
claude mcp add attio node /absolute/path/to/attio-mcp/dist/index.js
Adding Custom Objects
This template includes tools for standard Attio objects (companies, people). To add tools for your custom objects:
- Use
get_workspace_schemato discover your workspace's objects and attributes - Copy an existing tool (e.g.,
search-companies.ts) as a template - Modify the API endpoint, fields, and types for your custom object
- Register the new tool in
src/tools/index.ts
Development
npm run dev # Watch mode
npm run build # Build
npm test # Run tests
npm run test:watch # Watch tests
License
MIT
