Attio MCP Server

A Model Context Protocol (MCP) server for Attio, the AI-native CRM. This server enables AI assistants like Claude to interact directly with your Attio data, providing a seamless integration between conversational AI and your CRM.

🚀 Key Features

Comprehensive Attio API Support
- Companies: Search, view details, manage notes
- People: Search (with email/phone support), view details, manage notes
- Lists: View, manage entries, add/remove records
- Records: Create, read, update, delete (coming soon)
- Tasks: Create, update, and link to records
Enhanced Capabilities
- Robust error handling with helpful messages
- Automatic retry logic with exponential backoff
- Input validation to prevent common errors
- Standardized response formatting

🔍 Example: Using with Claude

Ask Claude natural questions about your Attio data:

"Find all technology companies in our CRM"
"Add a note to Acme Corporation about our recent product demo"
"Show me all contacts from Microsoft who were added this month"
"Add Sarah Johnson's new phone number: +1-555-123-4567"

⚡ Quick Start

Prerequisites

Node.js (v18 or higher)
Attio API Key (Get one here)

Installation

npm install attio-mcp-server

Configuration for Claude Desktop

{
  "mcpServers": {
    "attio": {
      "command": "npx",
      "args": ["attio-mcp-server"],
      "env": {
        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
      }
    }
  }
}

🌐 Deployment Options

Local Development: Development Guide
Docker: Docker Guide
- Easy setup with Docker Compose
- Health checks included
- Configurable through environment variables

📚 Documentation

Full documentation is available in the docs directory:

Getting Started
API Reference
Deployment
- Docker Guide
- Security Best Practices
Development

🤝 Contributing

Contributions are welcome! Please see our Contributing Guidelines for details on how to submit pull requests, report issues, and suggest improvements.

📄 License

This project is licensed under the BSD 3-Clause License - see the LICENSE file for details.