How do I use Attio Simple MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Attio Simple MCP Server find the contact info for Jane Smith at Acme Corp" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Attio Simple MCP Server

An MCP (Model Context Protocol) server that integrates Attio CRM with AI clients like Claude Code, Claude Desktop, ChatGPT, Windsurf, and Cursor.

This template was created by Manoel Lemos 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

npm install

2. Configure Environment

cp .env.example .env

Edit .env and add your Attio API key:

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.

3. Build

npm run build

4. Configure Your AI Client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{ "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

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:

Use get_workspace_schema to discover your workspace's objects and attributes
Copy an existing tool (e.g., search-companies.ts) as a template
Modify the API endpoint, fields, and types for your custom object
Register the new tool in src/tools/index.ts

Development

npm run dev # Watch mode npm run build # Build npm test # Run tests npm run test:watch # Watch tests

License

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Tools

View all tools

Attio Simple MCP Server

Attio Simple MCP Server

Features

Available Tools

Quick Start

1. Install Dependencies

2. Configure Environment

3. Build

4. Configure Your AI Client

Claude Desktop

Claude Code

Adding Custom Objects

Development

License

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API