# Attio

> Official Attio MCP — natural-language CRM control across records, lists, and notes via OAuth.

[Canonical HTML page](https://top-mcps.com/mcp/attio) · [server.json](https://top-mcps.com/mcp/attio.json) · [methodology](https://top-mcps.com/about/methodology)

## At a glance

- **Maintainer:** Attio
- **Transport:** Streamable HTTP
- **Auth model:** OAuth 2.1
- **Required secrets:** None
- **Supported clients:** Claude, Cursor, ChatGPT, Raycast, Any MCP-compatible client
- **License:** Proprietary
- **Last verified:** 2026-06-11
- **Score:** 57/100 (rubric 2026-04 — see https://top-mcps.com/about/methodology)
- **Homepage:** https://docs.attio.com/mcp/overview

## Security & scope

- **Access scope:** read-write
- **Sandbox:** Hosted by Attio. OAuth-scoped to the connecting user. Workspace admins can disable third-party MCP access at the workspace level.
- **Gotchas:**
  - A connected agent can update deal stages and create records — restrict the OAuth grant if the agent should only read.
  - Note attribution shows the OAuth user — agent-created notes appear under the connecting user's name in the activity feed.

## Quick answer

**What it does.** Exposes Attio's records, lists, attributes, notes, and workspace metadata as MCP tools. Hosted remote endpoint with OAuth scoped to the connecting user.

**Best for:**
- Natural-language CRM management
- Pipeline updates from an agent
- Note-taking against people and companies
- AI-driven prospect research → record creation
- Cross-list "who matches X" queries

**Not for:**
- Teams not on Attio
- Bulk imports (use the REST API)
- Read-only analytics over a warehouse mirror

## Recipes

### Update a deal stage and append a meeting note

```
In Attio, find the deal for Acme Corp, move it to "Negotiation" stage, and append a note dated today summarising: pricing was the main objection, decision expected by end of month.
```

_Tested with: Claude Desktop, Claude Web, ChatGPT_

## Description

Attio is the mid-market CRM of choice for AI-first GTM teams, and its official remote MCP at `https://mcp.attio.com/mcp` exposes the full workspace to AI clients via one-click OAuth. Search and update records (people, companies, deals), append notes, filter by any attribute, and let an agent manage pipeline state in natural language. Hosted by Attio; no self-hosting required.

## Why it matters

Attio rebuilt CRM around the assumption that AI agents would be first-class users — every record is queryable by attribute, every list is filter-driven, and the API surface mirrors the UI exactly. The first-party MCP is the natural endpoint for that thesis: Claude can search people, update a deal stage, or append a meeting note as cleanly as a human can.

## Key features

- Official remote MCP at `https://mcp.attio.com/mcp`
- One-click OAuth — listed in Claude, ChatGPT, and Raycast directories
- Full workspace access: records, lists, notes, attributes
- Natural-language record search and update
- Hosted by Attio — no self-hosting

## FAQ

### How is access scoped?

OAuth on the Attio side — the connector sees what the connecting user can see. Workspace admins can disable third-party MCP access globally if a more restrictive posture is required.

### Can it write records, or only read?

Both. The MCP exposes create/update tools for records, lists, and notes. Agents can move a deal stage, append a meeting note, or create a new person record from a natural-language prompt.

### How does this compare to the community `kesslerio/attio-mcp-server` repo?

The community server is the right pick if you want self-hosted control over OAuth and secret storage. For the shortest path to a single workspace in Claude or ChatGPT, the first-party hosted MCP at `mcp.attio.com/mcp` is the recommended default.

### Is there a rate limit?

Yes — Attio enforces per-workspace API limits. Tight agent loops can hit them; the server returns 429s as tool errors so the model can back off and retry.

## Changelog

- **2026-06-11** — Refreshed install snippets and fact sheet; verified for 2026.
- **2025-12-01** — Initial directory listing.
