Attio Simple MCP Server

An MCP (Model Context Protocol) server that integrates Attio CRM with AI clients like Claude Code, Claude Desktop, ChatGPT, Windsurf, and Cursor.

This template was created by Manoel Lemos as a shortcut for people interested in deploying Attio MCP servers.

Features

• 14 Tools for managing companies, people, and notes in Attio
• Schema Discovery - Dynamically discover your workspace's objects and attributes
• Type-Safe - Full TypeScript with auto-generated Attio API types

Available Tools

Category	Tools
Schema	get_workspace_schema
Companies	search_companies, get_company, create_company, update_company, manage_company_domains
People	search_people, get_person, create_person, update_person, manage_person_emails, manage_person_tags
Notes	create_note, get_note

Quick Start

1. Install Dependencies

npm install

2. Configure Environment

cp .env.example .env

Edit .env and add your Attio API key:

ATTIO_API_KEY="your_api_key_here"
ATTIO_WORKSPACE_SLUG="your-workspace-slug"  # Optional: for web URLs

Get your API key from Attio Settings > Developers > API Keys.

3. Build

npm run build

4. Configure Your AI Client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "attio": {
      "command": "node",
      "args": ["/absolute/path/to/attio-mcp/dist/index.js"],
      "env": {
        "ATTIO_API_KEY": "your_api_key_here",
        "ATTIO_WORKSPACE_SLUG": "your-workspace-slug"
      }
    }
  }
}

Claude Code

claude mcp add attio node /absolute/path/to/attio-mcp/dist/index.js

Adding Custom Objects

This template includes tools for standard Attio objects (companies, people). To add tools for your custom objects:

1. Use get_workspace_schema to discover your workspace's objects and attributes
2. Copy an existing tool (e.g., search-companies.ts) as a template
3. Modify the API endpoint, fields, and types for your custom object
4. Register the new tool in src/tools/index.ts

Development

npm run dev          # Watch mode
npm run build        # Build
npm test             # Run tests
npm run test:watch   # Watch tests

License

MIT