AFFiNE MCP Server
AFFiNE MCP server enabling AI agents to interact with AFFiNE — the open-source Notion/Miro alternative — reading and writing documents and notes, searching workspace content, managing page hierarchies, accessing block-level content, and integrating AFFiNE's knowledge workspace into agent-driven note-taking and knowledge management workflows.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Token auth. HTTPS. Official AFFiNE MCP. Self-hosting for full data control. Store token securely.
⚡ Reliability
Best When
A team using AFFiNE as their knowledge workspace needs AI-assisted document creation and retrieval — particularly valuable for users who self-host AFFiNE for privacy.
Avoid When
You use Notion, Obsidian, or other PKM tools — or don't have an AFFiNE instance.
Use Cases
- • Reading and writing AFFiNE notes and documents from knowledge management agents
- • Searching workspace content from research assistant agents
- • Creating structured documents from content generation agents
- • Managing page hierarchies and nested notes from organization agents
- • Integrating AFFiNE with AI-driven daily note workflows
- • Accessing block-level document content from analysis agents
Not For
- • Notion, Obsidian, or Roam users (use their respective MCPs)
- • Teams not using AFFiNE for knowledge management
- • Large-scale content migration tasks (block-level API may be verbose)
Interface
Authentication
AFFiNE user token required. Available from AFFiNE account settings. Self-hosted AFFiNE supports token auth. AFFiNE Cloud (affine.pro) also supported.
Pricing
AFFiNE is open source — self-host for free with no limits. AFFiNE Cloud free tier available. Official MCP from AFFiNE/Toeverything team.
Agent Metadata
Known Gotchas
- ⚠ AFFiNE uses block-level content model — content structure differs from linear docs
- ⚠ GraphQL API used internally — MCP abstracts this but schema knowledge helps
- ⚠ Self-hosted AFFiNE requires proper setup (Docker recommended)
- ⚠ AFFiNE is relatively young product — API may evolve with new features
- ⚠ Official MCP from Toeverything (AFFiNE creators) — higher quality baseline
- ⚠ Workspace and document IDs required for most operations
Alternatives
Full Evaluation Report
Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for AFFiNE MCP Server.
Scores are editorial opinions as of 2026-03-06.