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

  • Installation & Setup
  • Claude Desktop Config
  • Troubleshooting Guide

• API Reference

  • API Overview
  • People API
  • Companies API
  • Lists API
  • Notes API

• Deployment

  • Docker Guide
  • Security Best Practices

• Development

  • Contributing Guidelines
  • Error Handling
  • Extending MCP

🤝 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.