Attio MCP Server

🚀 attio-mcp-server

The MCP server for Attio, which enables MCP clients (e.g., Claude) to connect to the Attio API.

🚀 Quick Start

This is an MCP server designed for Attio. It enables MCP clients, such as Claude, to establish a connection with the Attio API.

✨ Features

• [x] Read company records
• [x] Read company notes
• [x] Write company notes
• [ ] Other activities

💻 Usage Examples

Basic Usage

You need to have the following:

• ATTIO_API_KEY

This is a bearer token. You can obtain it from the right side of the API Explorer or configure OAuth via the Attio API and retrieve it.

Configuration for Claude Desktop

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

📚 Documentation

Prerequisites

Before you start, make sure you have installed the following software:

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

Setting up the Development Environment

To set up the development environment, follow these steps:

1. Fork the repository

   • Click the "Fork" button in the upper right corner of this repository.
   • This will create your own copy of the repository under your GitHub account.

2. Clone your repository:

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

3. Add the 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 the watcher 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
   

⚠️ Important Note

If the development server fails to load environment variables correctly, set ATTIO_API_KEY on the left side of the MCP inspector.