Attio MCP Server

A comprehensive Model Context Protocol (MCP) server for Attio, enabling AI assistants like Claude to interact with your CRM through natural language.

Transform your CRM workflows: "Find all AI companies with 50+ employees that we haven't contacted in 30 days"

✨ Key Features

• Universal Tools: 13 tools work across all record types (companies, people, deals, lists, tasks)
• Natural Language: Search, create, update, and manage CRM data conversationally
• Advanced Filtering: Complex multi-condition searches with relationship-based queries
• Batch Operations: Process hundreds of records efficiently
• Full CRUD: Complete create, read, update, delete capabilities for all record types

🚀 Quick Start

Installation

# Install globally
npm install -g attio-mcp-server

# Or clone for development
git clone https://github.com/kesslerio/attio-mcp-server.git
cd attio-mcp-server
npm install

Configuration

1. Get your Attio API key: Attio Developer Documentation

2. Configure environment:

   export ATTIO_API_KEY="your_api_key_here"
   

3. Add to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

   {
     "mcpServers": {
       "attio": {
         "command": "attio-mcp-server",
         "env": {
           "ATTIO_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

💬 Example Usage

Once configured, interact with your Attio CRM naturally:

Find technology companies in San Francisco with more than 100 employees
Create a new deal for $50,000 with Acme Corp
Add John Smith to our Q4 prospects list
Show me all overdue tasks assigned to the sales team

📚 Documentation

• Getting Started - Detailed setup and installation
• User Guide - Common workflows and examples
• API Reference - Complete tool documentation
• Deployment - Docker and production deployment
• Development - Contributing and extending

🔧 Core Tools

Tool	Purpose
search-records	Find any record type with flexible criteria
get-record-details	Retrieve complete record information
create-record	Create companies, people, deals, tasks, etc.
update-record	Modify existing records
delete-record	Remove records safely
advanced-search	Complex multi-condition filtering
batch-operations	Process multiple records efficiently

🐳 Docker Deployment

# Quick start with Docker
docker run -e ATTIO_API_KEY=your_key_here attio-mcp-server

# Or use Docker Compose
echo "ATTIO_API_KEY=your_key_here" > .env
docker-compose up -d

🤝 Contributing

We welcome contributions! See our Contributing Guide for details on:

• Setting up the development environment
• Running tests and linting
• Submitting pull requests
• Code standards and best practices

📄 License

This project is licensed under the Apache License 2.0. See LICENSE for details.

🔗 Links

• Documentation: Full Documentation
• Issues: Report bugs or request features
• Smithery: Install via Smithery
• Attio: Learn more about Attio CRM

---

Need help? Check our troubleshooting guide or open an issue.