# Work with AFFiNE workspaces, documents, and databases from MCP-compatible agents

> Use affine-mcp-server when an agent needs tool-callable access to AFFiNE workspaces, documents, databases, and comments inside an MCP workflow instead of sending a user back to the AFFiNE UI.

- Skill: `agentskillexchange/work-with-affine-workspaces-documents-and-databases-from-mcp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/work-with-affine-workspaces-documents-and-databases-from-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/work-with-affine-workspaces-documents-and-databases-from-mcp/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/work-with-affine-workspaces-documents-and-databases-from-mcp

---


# Work with AFFiNE workspaces, documents, and databases from MCP-compatible agents

Use affine-mcp-server when an agent needs tool-callable access to AFFiNE workspaces, documents, databases, and comments inside an MCP workflow instead of sending a user back to the AFFiNE UI.

## Prerequisites

Node.js, an MCP-compatible client, and access to an AFFiNE Cloud or self-hosted instance with an API token or saved credentials.

## Installation

Use the upstream install or setup path that matches your environment:
- npm i -g affine-mcp-server
- npx -y -p affine-mcp-server affine-mcp -- --version
- docker run -d \
- npm run build

Requirements and caveats from upstream:
- Includes Docker images, health probes, and end-to-end test coverage
- AFFiNE Cloud requires API-token-based access for MCP usage; programmatic email/password sign-in is blocked by Cloudflare
- | Run the server in Docker or another OCI runtime | [docs/getting-started.md#path-c-run-from-the-docker-image](docs/getting-started.md#path-c-run-from-the-docker-image) |

Basic usage or getting-started notes:
- [Quick Start](#quick-start)
- Run a local stdio MCP server for Claude Code, Codex CLI, Cursor, or Claude Desktop
- | Run the server remotely over HTTP or behind OAuth | [docs/configuration-and-deployment.md](docs/configuration-and-deployment.md) |

- Source: https://github.com/DAWNCR0W/affine-mcp-server
- Extracted from upstream docs: https://raw.githubusercontent.com/DAWNCR0W/affine-mcp-server/HEAD/README.md

## Documentation

- https://github.com/DAWNCR0W/affine-mcp-server/blob/main/docs/getting-started.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents/)