Attio MCP Server

🚀 Attio MCP Server

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

Badges

✨ Features

Comprehensive Attio API Support

• Companies: Search, view details, and manage notes.
• People: Search (with email/phone support), view details, and manage notes.
• Lists: View, manage entries, and add/remove records.
• Records: Create, read, update, and 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.

💻 Usage Examples

Basic Usage

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.