# Attio Simple MCP Server
An MCP (Model Context Protocol) server that integrates [Attio CRM](https://attio.com) with AI clients like Claude Code, Claude Desktop, ChatGPT, Windsurf, and Cursor.
This template was created by [Manoel Lemos](mailto:manoel@lemos.net) as a shortcut for people interested in deploying Attio MCP servers.
## Features
- **14 Tools** for managing companies, people, and notes in Attio
- **Schema Discovery** - Dynamically discover your workspace's objects and attributes
- **Type-Safe** - Full TypeScript with auto-generated Attio API types
## Available Tools
| Category | Tools |
|----------|-------|
| Schema | `get_workspace_schema` |
| Companies | `search_companies`, `get_company`, `create_company`, `update_company`, `manage_company_domains` |
| People | `search_people`, `get_person`, `create_person`, `update_person`, `manage_person_emails`, `manage_person_tags` |
| Notes | `create_note`, `get_note` |
## Quick Start
### 1. Install Dependencies
```bash
npm install
```
### 2. Configure Environment
```bash
cp .env.example .env
```
Edit `.env` and add your Attio API key:
```bash
ATTIO_API_KEY="your_api_key_here"
ATTIO_WORKSPACE_SLUG="your-workspace-slug" # Optional: for web URLs
```
Get your API key from [Attio Settings > Developers > API Keys](https://app.attio.com).
### 3. Build
```bash
npm run build
```
### 4. Configure Your AI Client
#### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
```json
{
"mcpServers": {
"attio": {
"command": "node",
"args": ["/absolute/path/to/attio-mcp/dist/index.js"],
"env": {
"ATTIO_API_KEY": "your_api_key_here",
"ATTIO_WORKSPACE_SLUG": "your-workspace-slug"
}
}
}
}
```
#### Claude Code
```bash
claude mcp add attio node /absolute/path/to/attio-mcp/dist/index.js
```
## Adding Custom Objects
This template includes tools for standard Attio objects (companies, people). To add tools for your custom objects:
1. Use `get_workspace_schema` to discover your workspace's objects and attributes
2. Copy an existing tool (e.g., `search-companies.ts`) as a template
3. Modify the API endpoint, fields, and types for your custom object
4. Register the new tool in `src/tools/index.ts`
## Development
```bash
npm run dev # Watch mode
npm run build # Build
npm test # Run tests
npm run test:watch # Watch tests
```
## License
MIT
