Attio MCP Server

1# attio-mcp-server
2 
3This is an MCP server for [Attio](https://attio.com/), the AI-native CRM. It allows mcp clients (like Claude) to connect to the Attio API.
4 
5#### Current Capabilities
6 
7- [x] reading company records
8- [x] reading company notes
9- [x] writing company notes
10- [ ] other activities
11 
12## Usage
13 
14You will need:
15 
16- `ATTIO_API_KEY` 
17 
18This is expected to be a *bearer token* which means you can get one through the [API Explorer](https://developers.attio.com/reference/get_v2-objects) on the right hand side or configure OAuth and retrieve one throught the Attio API.
19 
20 
21### Claude Desktop Configuration
22 
23```json
24{
25  "mcpServers": {
26    "attio": {
27      "command": "npx",
28      "args": ["attio-mcp-server"],
29      "env": {
30        "ATTIO_API_KEY": "YOUR_ATTIO_API_KEY"
31      }
32    }
33  }
34}
35```
36## Development
37 
38### Prerequisites
39 
40Before you begin, ensure you have the following installed:
41 
42- Node.js (recommended v22 or higher)
43- npm
44- git
45- dotenv
46 
47### Setting up Development Environment
48 
49To set up the development environment, follow these steps:
50 
511. Fork the repository
52 
53   - Click the "Fork" button in the top-right corner of this repository
54   - This creates your own copy of the repository under your Github acocunt
55 
561. Clone Your Fork:
57 
58   ```sh
59   git clone https://github.com/YOUR_USERNAME/attio-mcp-server.git
60   cd attio-mcp-server
61   ```
62 
631. Add Upstream Remote
64   ```sh
65   git remote add upstream https://github.com/hmk/attio-mcp-server.git
66   ```
67 
681. Copy the dotenv file
69    ```sh
70    cp .env.template .env
71    ```
72 
731. Install dependencies:
74 
75   ```sh
76   npm install
77   ```
78 
791. Run watch to keep index.js updated:
80 
81   ```sh
82   npm run build:watch
83   ```
84 
851. Start the model context protocol development server:
86 
87   ```sh
88   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
89   ```
90 
911. 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.