Attio

This MCP server lets clients connect to Attio so you can read company records and notes, and write company notes through the Attio API. It provides a simple, secure bridge for MCP-enabled assistants to work with Attio data.

How to use

You connect an MCP client to the Attio MCP server to access Attio data. Start by configuring an MCP connection that uses the local Attio server endpoint. Provide your Attio API bearer token so requests to Attio are authenticated. With this setup you can read company records, read company notes, and write company notes through the Attio API.

How to install

Prerequisites you need before installing this MCP server are: Node.js (preferably v22 or newer), npm, git, and dotenv.

Install and run steps you should follow to get started include the following commands.

# 1) Ensure you have Node.js and npm installed
node -v
npm -v

# 2) Install dependencies for the MCP server project
npm install

# 3) If you want to actively watch for changes during development, build in watch mode
npm run build:watch

# 4) Run the MCP server with your Attio API key
# Replace YOUR_ATTIO_API_KEY with your actual key
ATTIO_API_KEY=YOUR_ATTIO_API_KEY npx attio-mcp-server
```}]} ,{

Additional sections

Configuration and usage details follow the JSON example you use to run the server. The key setup is to provide the Attio API bearer token and point the MCP client to the server. The following configuration snippet shows how to register the Attio MCP server under the name attio using npx. This is what you would place in your client’s MCP configuration.

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

Notes on capabilities and security

Current capabilities include reading company records, reading company notes, and writing company notes. The server authenticates requests using the Attio API bearer token you provide. Keep your API key secure and do not commit it to public repositories.

Available tools

readCompany

Fetch and return company records from Attio based on query criteria.

readNotes

Fetch and return notes associated with a company from Attio.

writeNotes

Create or update notes attached to a company in Attio.