attio-mcp-server

This is an MCP server for Attio, the AI-native CRM. It allows mcp clients (like Claude) to connect to the Attio API.

Current Capabilities

• [x] reading company records
• [x] reading company notes
• [x] writing company notes
• [ ] other activities

Usage

You will need:

• ATTIO_API_KEY

This is expected to be a bearer token which means you can get one through the API Explorer on the right hand side or configure OAuth and retrieve one throught the Attio API.

Claude Desktop Configuration

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

Development

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (recommended v22 or higher)
• npm
• git
• dotenv

Setting up Development Environment

To set up the development environment, follow these steps:

1. Fork the repository

   • Click the “Fork” button in the top-right corner of this repository
   • This creates your own copy of the repository under your Github acocunt

2. Clone Your Fork:

   git clone https://github.com/YOUR_USERNAME/attio-mcp-server.git
   cd attio-mcp-server
   

3. Add Upstream Remote

   git remote add upstream https://github.com/hmk/attio-mcp-server.git
   

4. Copy the dotenv file

   cp .env.template .env
   

5. Install dependencies:

   npm install
   

6. Run watch to keep index.js updated:

   npm run build:watch
   

7. Start the model context protocol development server:

   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
   

8. If the development server did not load the environment variable correctly, set the ATTIO_API_KEY on the left-hand side of the mcp inspector.