affine-mcp-server-integration — Claude Code skill
affine-mcp-server-integration connects AI assistants to AFFiNE workspaces via the Model Context Protocol. Useful for searching, editing, and organizing docs directly from chat.
no license 116 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill affine-mcp-server-integration -a claude-codeWhat affine-mcp-server-integration does
This skill provides setup guidance and operational rules for affine-mcp-server. It enables coding assistants to talk to AFFiNE Cloud or self-hosted instances. The underlying server exposes 85 tools covering workspace listings, document search, template creation, and trash restoration.
Execution happens locally via stdio using the npm package or over HTTP through an official Docker container. Local credentials can be stored via affine-mcp login with file permissions set to 600. Without a valid API token or login credentials, calls to the AFFiNE workspace fail immediately.
What it helps with
- connect Claude Code or Cursor to an AFFiNE workspace
- create and modify documents programmatically via MCP tools
- deploy a remote HTTP MCP bridge using Docker
- diagnose connectivity and active configuration using affine-mcp doctor
Example prompts for the agent
- Connect my Claude Code session to my AFFiNE workspace
- Search AFFiNE notes for meeting notes and summarize them
- Run affine-mcp doctor to check my connection status
How to install affine-mcp-server-integration
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill affine-mcp-server-integration -a claude-code2Manually: put the files in place
~/.claude/skills/affine-mcp-server-integration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/affine-mcp-server-integration/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill affine-mcp-server-integration -a codex2Manually: put the files in place
.agents/skills/affine-mcp-server-integration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill affine-mcp-server-integration -a cursor2Manually: put the files in place
.cursor/skills/affine-mcp-server-integration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/affine-mcp-server-integration2Manually: put the files in place
.github/skills/affine-mcp-server-integration/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill affine-mcp-server-integration -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/affine-mcp-server-integrationManually: put the files in place
.devin/skills/affine-mcp-server-integration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill affine-mcp-server-integration -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about affine-mcp-server-integration
How to install affine-mcp-server-integration in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill affine-mcp-server-integration -a claude-code in your terminal.
What does affine-mcp-server-integration do?
It gives your agent instructions to run and use the AFFiNE MCP server, granting access to 85 tools for documents, templates, and databases.
Can I use it with self-hosted AFFiNE instances?
Yes. Set AFFINE_BASE_URL to your domain and authenticate with personal access tokens, email and password pairs, or cookies.