home / mcp / attio mcp server

Attio MCP Server

Attio Model Context Protocol (MCP) server implementation

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "arjunkmrm-attio-mcp-server": {
      "url": "https://server.smithery.ai/@kesslerio/attio-mcp-server/mcp",
      "headers": {
        "ATTIO_API_KEY": "your_api_key_here",
        "ATTIO_ACCESS_TOKEN": "oauth_access_token_here",
        "ATTIO_WORKSPACE_ID": "workspace_12345",
        "ATTIO_DEFAULT_CURRENCY": "USD",
        "ATTIO_DEFAULT_DEAL_OWNER": "[email protected]",
        "ATTIO_DEFAULT_DEAL_STAGE": "Interested"
      }
    }
  }
}

Attio MCP Server lets you control your entire Attio CRM through natural language. You can ask an AI assistant to find companies, people, deals, tasks, lists, notes, and records, or to perform bulk actions and advanced searches, all powered by a production-ready MCP surface that stays in sync with Attio.

How to use

You connect an MCP client (such as Claude, ChatGPT, or other compatible assistants) to the Attio MCP Server and interact with your Attio workspace using natural language. Tell it to search for records, create or update entities, move deals through stages, manage lists, assign tasks, log activities, or fetch details across Companies, People, Deals, Tasks, Lists, and Notes. The system translates your natural language requests into Attio API actions, while handling field mappings, relationship navigation, and batch operations behind the scenes. You can also use pre-built prompts to accelerate common workflows for sales, marketing, customer success, and data operations.

How to install

Prerequisites: you need Node.js v18 or higher, an Attio workspace, and authentication credentials (an Attio API key or an OAuth access token) plus the workspace ID.

Choose an installation method that fits your setup and security preferences. The following options are all valid ways to run the MCP server and connect your MCP client.

# Tier 1: Smithery (One-Click) - Recommended

# Claude Desktop via Smithery
npx -y @smithery/cli install @kesslerio/attio-mcp-server --client claude

# Cursor IDE via Smithery
npx -y @smithery/cli install @kesslerio/attio-mcp-server --client cursor

# ChatGPT Developer Mode
# 1. Enable Developer Mode
# 2. Add MCP Server URL
# 3. Complete OAuth authorization when prompted
https://server.smithery.ai/@kesslerio/attio-mcp-server/mcp

# Claude Web
# 1. Go to Claude Settings
# 2. Add MCP connector
# 3. Select Attio CRM from Smithery marketplace
# 4. Authorize with your Attio account
```

```bash
# Tier 2: Shell Installers

# Claude Desktop
curl -fsSL https://raw.githubusercontent.com/kesslerio/attio-mcp-server/main/scripts/install-claude-desktop.sh | bash

# Cursor IDE
curl -fsSL https://raw.githubusercontent.com/kesslerio/attio-mcp-server/main/scripts/install-cursor.sh | bash

# Claude Code (CLI)
curl -fsSL https://raw.githubusercontent.com/kesslerio/attio-mcp-server/main/scripts/install-claude-code.sh | bash
```

```bash
# Tier 3: Manual Configuration

# Claude Desktop: install the MCP CLI and set ATTIO_API_KEY
npm install -g attio-mcp

echo '{"mcpServers": {"attio-mcp": {"command": "attio-mcp","env": {"ATTIO_API_KEY": "your_api_key_here"}}}}' > ~/.claude/claude_desktop_config.json
```

```bash
# Tier 3: Manual Configuration (Cursor IDE example)
npm install -g attio-mcp

# Cursor config example
# Edit ~/.cursor/mcp.json to include the attio-mcp server with the same env var
```]} ,{

Additional sections

Security and deployment options let you tailor the MCP server to your environment. You can use a remote OAuth-enabled setup via Smithery or run a local CLI-based installation that you control. The HTTP-based Smithery integration provides centralized authentication and browser/mobile access, while local installations give you full control over the runtime. For teams needing centralized OAuth, multi-user access, or mobile access, a Cloudflare Worker deployment is described as a remote hosting option, though you should follow the deployment steps and security practices that apply to your organization.

Environment variables you’ll commonly configure include the Attio API key, the workspace ID, and defaults for new deals. You can also enable optional flags to control default deal stages, owners, and currencies. Use these to tailor how the MCP server creates and updates records in Attio.

Recommended starting points for the host configuration include choosing an authentication method (API key or OAuth) and setting your workspace ID. Then test your installation by discovering workspace attributes and performing a few read/write actions in a dry run if supported by your client.