Attio MCP Server

by MCP-Mirror

382 downloads
Not rated
GitHub

About

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 a seamless integration between conversational AI and your CRM.

Details

Author
MCP-Mirror
Downloads
382
Categories
Other

- Search and view company, people, and list details
- Manage notes on companies and people
- Create, update, and link tasks to records
- Automatic retry logic with exponential backoff
- Input validation and standardized response formatting

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Attio MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npm (npm install attio-mcp-server), then configure the server in Claude Desktop using the provided JSON snippet, setting your Attio API key in the environment variables. The server runs with Node.js v18 or higher.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Attio MCP Server

License: BSD 3-Clause
CI/CD Pipeline
codecov
Node.js Version
npm version

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.