attio-mcp-server

by kesslerio

316 downloads
Not rated
GitHub

About

Attio Model Context Protocol (MCP) server implementation

Details

Author
kesslerio
Downloads
316
Categories
Other

- Reading company records from Attio
- Reading company notes in Attio
- Writing company notes to Attio

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name attio-mcp-server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

You need an ATTIO_API_KEY (a bearer token) obtained through the API Explorer or OAuth. Configure the server in your MCP client (e.g., Claude Desktop) using npx attio-mcp-server and set the environment variable ATTIO_API_KEY.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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

- [x] reading company records
- [x] reading company notes
- [x] 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

1. Clone Your Fork:

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

1. Add Upstream Remote

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

1. Copy the dotenv file

    cp .env.template .env

1. Install dependencies:

   npm install
   

1. Run watch to keep index.js updated:

   npm run build:watch
   

1. Start the model context protocol development server:

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

1. 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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.