playbooks

Home / MCP / Attio MCP Server

Attio MCP Server

Exposes an MCP server that reads and writes Attio data via the API for MCP clients.

javascript
16stars
View on GitHub
Installation
Add the following to your MCP client configuration file.

Configuration

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

You can run an Attio MCP Server that lets clients like Claude connect to the Attio API to read company data and notes, and to write company notes. It exposes Attio data to MCP clients in a controlled, programmable way and supports secure access via an API key.

How to use

Once the Attio MCP Server is running, you configure your MCP client to connect through the server using the provided command. You will supply your Attio API bearer token to authorize requests. The server currently supports reading company records, reading company notes, and writing company notes.

To connect with an MCP client (for example Claude Desktop), configure the MCP server entry with the following settings. The API key must be supplied as an environment variable in your running environment so the client can authenticate to Attio.

Example client configuration for Claude Desktop:

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

How to install

Prerequisites you need before starting work on this server: Node.js (recommended v22 or higher), npm, git, and dotenv.

Follow these concrete steps to set up the development environment and run the server locally.

# Prerequisites
# Install Node.js (v22+), npm, and git on your system.

Development setup and running the server

1) Fork the repository to your GitHub account.

2) Clone your fork and enter the project directory.

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

3) Add the upstream remote to keep your copy up to date.

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

4) Copy the dotenv template to create your local environment file.

cp .env.template .env

5) Install project dependencies.

npm install

6) Run a watcher to rebuild index.js on changes.

npm run build:watch

7) Start the model context protocol development server. You will point to the cloned repository's built index after environment configuration.

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

8) If the environment variable did not load correctly, ensure ATTIO_API_KEY is set in the left-hand side of the MCP inspector so the server can authenticate with Attio.

Configuration and security notes

Environment variables shown for this MCP server include ATTIO_API_KEY. This value must be provided as a bearer token to authorize requests against the Attio API.

Keep your API key secure. Do not commit it to version control. Use environment management practices to rotate keys and restrict access.

Available tools

readCompany

Fetch and return company records from Attio, enabling MCP clients to access company data.

readNotes

Read notes associated with a company to surface contextual information to MCP clients.

writeNotes

Create or append notes to a company in Attio on behalf of an MCP client.