# affine-mcp-server

> Model Context Protocol server for AFFiNE. Connect AI assistants to AFFiNE workspaces, documents, databases, and collaboration APIs over stdio or HTTP.

- **URL**: https://www.freshcrate.ai/projects/affine-mcp-server
- **Author**: DAWNCR0W
- **Category**: MCP Servers
- **Latest version**: `v2.1.0` (2026-05-21)
- **License**: MIT
- **Source**: https://github.com/DAWNCR0W/affine-mcp-server
- **Homepage**: https://glama.ai/mcp/servers/@DAWNCR0W/affine-mcp-server
- **Language**: TypeScript
- **GitHub**: 147 stars, 54 forks
- **Registry**: github
- **Tags**: `affine`, `ai-assistants`, `claude`, `codex`, `cursor`, `knowledge-base`, `mcp`, `model-context-protocol`, `typescript`

## Description

Model Context Protocol server for AFFiNE. Connect AI assistants to AFFiNE workspaces, documents, databases, and collaboration APIs over stdio or HTTP.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v2.1.0` | 2026-05-21 | High | ### Highlights - Added `find_doc_by_title` for fast exact-title lookup from AFFiNE workspace metadata, including duplicate-title results, timestamps, result limits, optional case-insensitive matching, and truncation reporting. - Added `folderId` support to `create_doc` so new documents can be placed directly inside AFFiNE organize folders. - Migrated npm publishing to GitHub Actions trusted publishing with OIDC on Node.js 24. - Cleared npm audit findings by refreshing locked transitive dependen |
| `v2.0.0` | 2026-05-07 | High | ### Highlights - Added native edgeless canvas coverage for surface elements, edgeless blocks, frame ownership, connector auto-snap, and canvas inspection. - Added least-privilege tool profiles for `full`, `read_only`, `core`, and `authoring` deployments. - Reduced the public MCP surface to 84 canonical tools by removing redundant convenience tools that overlapped with canonical document, search, database, comment, and template flows. - Hardened tool-surface reporting so `tools/list`, `get_capab |
| `v1.13.0` | 2026-04-10 | High | ### Highlights - Added high-level AFFiNE-native authoring workflows for semantic pages, native templates, fidelity analysis, and workspace blueprints. - Added structured mutation receipts so MCP clients can reliably consume IDs, warnings, and follow-up handles from write operations. - Expanded public docs into a productized landing page plus dedicated setup, deployment, workflow, and tool reference guides. - Refreshed CI and release dependencies across GitHub Actions, Docker publishing, and run |
| `v1.12.0` | 2026-04-09 | Medium | ## Version 1.12.0 (2026-04-09)  ### Highlights - Added linked-document support on database rows so a row can open an AFFiNE doc in center peek. - Restored MCP CRUD compatibility for database rows created directly in the AFFiNE UI. - Fixed self-hosted `affine:table` exports that store row, column, and cell data as flat dot-notation Y.js keys. - Added GHCR Docker publishing on release tags, guarded so image publication only proceeds when the tagged commit is reachable from `origin/main`.  ### What |
| `v1.11.2` | 2026-03-31 | Medium | ## Version 1.11.2 (2026-03-31)  ### Highlights - Corrected stale `list_docs` edge results so deleted documents no longer linger after `delete_doc`. - Completed the delete/list_docs hardening started in `v1.11.1` by keeping the visible edge list aligned with workspace metadata. - Revalidated the delete/list workflow live against AFFiNE `0.26.4`.  ### What Changed - `src/tools/docs.ts`   - Filter out deleted documents that remain in GraphQL edges after the workspace snapshot has already dropped th |
| `v1.11.1` | 2026-03-31 | Medium | ## Version 1.11.1 (2026-03-31)  ### Highlights - Corrected stale `list_docs` metadata after `delete_doc` so callers no longer see a pre-delete `totalCount`. - Aligned `list_docs.pageInfo.endCursor` with the returned edge list after delete-driven metadata drift. - Added live regression coverage to keep the delete/list_docs workflow stable against AFFiNE `0.26.4`.  ### What Changed - `src/tools/docs.ts`   - Clamp `list_docs.totalCount` downward when the workspace snapshot shows fewer pages than Gr |
| `v1.11.0` | 2026-03-27 | Medium | ### Highlights - Added full sidebar organize workflows for collections, folders, and links inside AFFiNE workspace trees. - Added configurable tool-surface filtering with `AFFINE_DISABLED_GROUPS` and `AFFINE_DISABLED_TOOLS`. - Added `delete_database_row` and fixed markdown import so list items and table cells keep inline rich-text marks in AFFiNE.  ### What Changed - `src/tools/organize.ts`, `README.md`, `tests/test-organize-tools.mjs`   - Added collection and folder management tools plus live |
| `v1.10.1` | 2026-03-18 | Low | ### Highlights - Refreshed the packaged README and release metadata so the published v1.10.x docs match the shipped toolset. - Tightened tag-based npm publication by requiring Docker-backed E2E validation before publish. - Kept the runtime/tool surface unchanged from `v1.10.0`; this is a documentation and release-process patch.  ### What Changed - `README.md`, `CHANGELOG.md`, `RELEASE_NOTES.md`, `tool-manifest.json`, `package.json`   - Bumped release metadata to `1.10.1`.   - Brought the package |
| `v1.10.0` | 2026-03-18 | Low | ### Highlights - Expanded document discovery and navigation with search, title lookup, backlinks, child/orphan traversal, and workspace tree tools. - Added template, batch, cleanup, and move workflows to cover higher-volume AFFiNE document operations. - Hardened remote HTTP deployments with optional OAuth mode, richer diagnostics, and a fix for repeated sessions using email/password authentication.  ### What Changed - `src/tools/docs.ts`   - Added `search_docs`, `get_doc_by_title`, `get_docs_by |
| `v1.9.0` | 2026-03-10 | Low | ### Highlights - Added dedicated database schema discovery with `read_database_columns`, so empty AFFiNE databases are now self-describing. - Added preset-backed `data_view` creation with kanban-oriented verification and richer exposed view metadata. - Hardened test infrastructure with a self-bootstrapping comprehensive runner, focused supporting-tools coverage, markdown callout round-trips, and a more reliable end-to-end Docker pipeline.  ### What Changed - `src/tools/docs.ts`   - Added `read_d |

## Dependency audit

- **Score**: 100/100
- **Total deps**: 19
- **Resolved**: 19
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 0
- **Scanned**: 2026-05-11

## Citation

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

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