mcpField
A
attio-mcp-server

attio-mcp-server

Local
github.com/hmkBusiness & Marketing16Updated 86w ago
Repository

About attio-mcp-server

attio-mcp-server connects MCP clients to the Attio API for company records and notes. It supports reading company data and adding notes to records.

Key features

  1. 01Read company records
  2. 02Read company notes
  3. 03Write company notes
  4. 04Authenticate with an Attio API bearer token

Use cases

  1. 01Review company profiles in Attio
  2. 02Read notes attached to companies
  3. 03Add a note to a company record

MCP support

The MCP server connects to the Attio API and lets MCP clients read company records and notes, and write company notes.

#attio#mcp-server#crm

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "attio-mcp-server-hmk": {
      "command": "npx",
      "args": [
        "-y",
        "attio-mcp-server"
      ],
      "env": {
        "ATTIO_API_KEY": "<ATTIO_API_KEY>"
      }
    }
  }
}
Run commandnpx -y attio-mcp-server
Environment variables to set
ATTIO_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmattio-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.