📌Overview

Purpose: To facilitate connections between MCP clients and the Attio API, streamlining the data interaction for AI-native CRM applications.

Overview: The Attio MCP Server acts as a bridge for MCP clients, enabling them to interact with various functionalities of the Attio API. This allows users to manage and retrieve company information seamlessly, enhancing productivity and data accessibility.

Key Features:

Reading Company Records: Allows MCP clients to fetch company details from the Attio database, providing valuable insights and information.
Writing Company Notes: Enables users to add notes about companies directly through the API, ensuring better organization and communication within the CRM.

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

reading company records
reading company notes
writing company notes
other activities (planned)

Usage

You will need:

ATTIO_API_KEY

This is expected to be a bearer token, which you can obtain through the API Explorer or by configuring OAuth to retrieve one via the Attio API.

Claude Desktop Configuration

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

Development

Prerequisites

Ensure you have the following installed:

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

Setting up Development Environment

Fork the repository under your GitHub account.

Clone your fork:

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

Add upstream remote:

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

Copy the dotenv file:
```
cp .env.template .env
```
Install dependencies:
```
npm install
```
Run watch to keep index.js updated:
```
npm run build:watch
```

Start the model context protocol development server:

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

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