# attio-mcp-server

> Attio Model Context Protocol (MCP) server implementation

- **URL**: https://www.freshcrate.ai/projects/attio-mcp-server
- **Author**: kesslerio
- **Category**: MCP Servers
- **Latest version**: `v1.6.1` (2026-05-14)
- **License**: NOASSERTION
- **Source**: https://github.com/kesslerio/attio-mcp-server
- **Language**: TypeScript
- **GitHub**: 67 stars, 18 forks
- **Registry**: github
- **Tags**: `typescript`

## Description

Attio Model Context Protocol (MCP) server implementation

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v1.6.1` | 2026-05-14 | High | New dedicated list configuration tools, npm provenance for supply chain verification, and Docker build fix.  ## What's New  ### Added  - **`create-list` tool** (#1195, #1196) - Dedicated list creation with template expansion (`sales_pipeline`, `recruiting_tracker`, `support_queue`), parent-object validation against workspace objects, and dry-run preview - **`update-list-configuration` tool** (#1195, #1196) - Dedicated list update with immutable field detection (rejects `parent_object` changes), |
| `v1.6.0` | 2026-05-05 | High | This release makes common company and deal writes easier, completes universal record support for custom objects, and fixes workspace-member lookups returned by list tools.  ## What's New  ### Added  - Scoped `create_company`, `update_company`, `create_deal`, and `update_deal` tools for high-frequency company/deal writes without manually selecting `resource_type` (#1175)  ### Changed  - Maintenance updates for npm trusted publishing reliability and current runtime/dependency compatibility (#1172, |
| `v1.5.0` | 2026-04-09 | High | This release adds record interaction history, expands search support for custom objects, and fixes several high-friction update, search, and validation issues across the Attio MCP server.  ## What's New  ### Added  - **`get_record_interactions` tool** (#1116) - Retrieve interaction history for a record without leaving the MCP workflow  ### Changed  - Search tools now accept config-discovered custom object slugs and preserve custom object labels in search output and errors (#1138) - `update_recor |
| `v1.4.1` | 2026-01-29 | Low | ## What's Changed  ### Added - **UniversalRecord type guards** (#1073) - Type discrimination functions for list/record handling   - `isAttioRecord()`, `isAttioList()`, `getRecordId()` functions   - Foundation for enforcing UniversalRecord type across universal tools  ### Changed - **Consolidated list filter tools (5 → 1)** (#1069) - Enhanced `filter-list-entries` with 4 auto-detected parameter modes - **Consolidated list entry management tools (3 → 1)** (#1075) - Enhanced `manage-list-entry` wit |
| `v1.4.0` | 2025-12-30 | Low | Changes since v1.3.6:  - Fix: Update @modelcontextprotocol/sdk peerDependency to ~1.24.0 #1063 (117bbb21) - Fix: Exclude failing CI tests from offline test suite #1061 (d53d18f7) - Fix: Skip status-field-validation test in CI until core package build added (ebcb64ce) - Release: v1.4.0 (eff5c6d0) - Refactor: Tool alias system simplification #1041 (#1057) (a0f5ba23) - Fix: Preserve line breaks in note content #1052 (12481e1a) - Refactor: Rename transformation type 'select_title_to_id' to 'select_t |
| `v1.3.6` | 2025-12-04 | Low | ## What's Changed  Documentation and testing infrastructure improvements for remote deployment support.  ### Added  - **Install Script Test Suite** (#958)   - 28 automated tests for bash install scripts   - Validates API key sanitization, config merging, prerequisite checks   - Tests for `install-claude-desktop.sh`, `install-cursor.sh`, `install-claude-code.sh`  - **E2E Remote Mode Troubleshooting Guide** (#958)   - Smithery debugging (scanner, OAuth, sessions)   - Cloudflare Worker debugging (E |
| `v1.3.5` | 2025-12-03 | Low | ## Self-host your own remote MCP server  **Use Attio from Claude.ai, ChatGPT, or any remote MCP client without relying on third-party platforms.**  This release addresses [Issue #928](https://github.com/kesslerio/attio-mcp-server/issues/928) by providing a **free, self-hosted alternative to Smithery** for remote OAuth MCP deployment. Deploy once to Cloudflare Workers (free tier) and access your Attio data from anywhere.  ### Why This Matters  - **No third-party dependencies** - Your credentials |
| `v1.3.0` | 2025-12-02 | Low | ## OAuth Access Token Support  This release adds comprehensive OAuth access token support, enabling delegated authentication for third-party integrations and users who prefer OAuth over API keys.  ### Added  - **`ATTIO_ACCESS_TOKEN` environment variable** - Alternative to `ATTIO_API_KEY` for OAuth integrations - **Local OAuth helper script** (`npm run oauth:setup`) - Interactive PKCE flow for obtaining tokens - **Token refresh command** (`npm run oauth:refresh`) - Refresh expired tokens - **Clou |
| `v1.2.2` | 2025-12-01 | Low | ## Critical Fixes  This release addresses critical bugs that made v1.2.1 non-functional.  ### Fixed  - **axios dependency** (#917, #919) - Fixed package crash on startup due to missing axios in dependencies. The package was completely broken. - **CLI symlink resolution** (#916, #920) - Fixed `attio-mcp --help` and `--version` not working when installed globally via npm.  ### Important  **v1.2.1 is broken** - please upgrade to v1.2.2 immediately.  ```bash npm install -g attio-mcp@1.2.2 ```  ### C |
| `v1.2.1` | 2025-11-28 | Low | Changes since v1.2.0:  - Chore: Bump version to 1.2.1 (#927) (fb89bea) - Feature: Improve deal field validation and stage discovery #925 (#926) (cfe0cc8) - Docs: Clarify npm package name (attio-mcp vs attio-mcp-server) #903 (#915) (246d221) - Chore(deps-dev): Bump vite in the npm_and_yarn group across 1 directory (#902) (3f86d43) - Chore(deps): Bump ora from 7.0.1 to 9.0.0 (#907) (4cd43f3) - Chore(deps-dev): Bump lint-staged from 16.1.6 to 16.2.6 (#908) (336f9f3) - Chore(deps-dev): Bump @typescr |

## Dependency audit

- **Score**: 98/100
- **Total deps**: 44
- **Resolved**: 44
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 1
- **Scanned**: 2026-05-25

## Citation

- HTML: https://www.freshcrate.ai/projects/attio-mcp-server
- Markdown: https://www.freshcrate.ai/projects/attio-mcp-server.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/attio-mcp-server/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._