{"id":"3c767935-2c92-4bdf-9cab-2127b61dd052","shortId":"WUfb4G","kind":"skill","title":"Work with AFFiNE workspaces, documents, and databases from MCP-compatible agents","tagline":"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.","description":"# Work with AFFiNE workspaces, documents, and databases from MCP-compatible agents\n\nUse 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.\n\n## Prerequisites\n\nNode.js, an MCP-compatible client, and access to an AFFiNE Cloud or self-hosted instance with an API token or saved credentials.\n\n## Installation\n\nUse the upstream install or setup path that matches your environment:\n- npm i -g affine-mcp-server\n- npx -y -p affine-mcp-server affine-mcp -- --version\n- docker run -d \\\n- npm run build\n\nRequirements and caveats from upstream:\n- Includes Docker images, health probes, and end-to-end test coverage\n- AFFiNE Cloud requires API-token-based access for MCP usage; programmatic email/password sign-in is blocked by Cloudflare\n- | 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) |\n\nBasic usage or getting-started notes:\n- [Quick Start](#quick-start)\n- Run a local stdio MCP server for Claude Code, Codex CLI, Cursor, or Claude Desktop\n- | Run the server remotely over HTTP or behind OAuth | [docs/configuration-and-deployment.md](docs/configuration-and-deployment.md) |\n\n- Source: https://github.com/DAWNCR0W/affine-mcp-server\n- Extracted from upstream docs: https://raw.githubusercontent.com/DAWNCR0W/affine-mcp-server/HEAD/README.md\n\n## Documentation\n\n- https://github.com/DAWNCR0W/affine-mcp-server/blob/main/docs/getting-started.md\n\n## Source\n\n- [Agent Skill Exchange](https://agentskillexchange.com/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents/)","tags":["work","with","affine","workspaces","documents","and","databases","from","mcp","compatible","agents","skills"],"capabilities":["skill","source-agentskillexchange","skill-work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents","topic-agent-skills","topic-ai-agents","topic-ai-tools","topic-awesome-list","topic-claude-code","topic-codex","topic-cursor","topic-llm","topic-mcp","topic-npx-skills","topic-openclaw","topic-skills-catalog"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/agentskillexchange/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add agentskillexchange/skills","source_repo":"https://github.com/agentskillexchange/skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,746 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:13:08.282Z","embedding":null,"createdAt":"2026-05-18T13:20:22.446Z","updatedAt":"2026-05-18T19:13:08.282Z","lastSeenAt":"2026-05-18T19:13:08.282Z","tsv":"'/dawncr0w/affine-mcp-server':259 '/dawncr0w/affine-mcp-server/blob/main/docs/getting-started.md':270 '/dawncr0w/affine-mcp-server/head/readme.md':266 '/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents/)':277 'access':25,71,101,178 'affin':3,15,27,45,49,61,73,91,104,134,141,145,171 'affine-mcp':144 'affine-mcp-serv':14,60,133,140 'agent':12,20,58,66,272 'agentskillexchange.com':276 'agentskillexchange.com/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents/)':275 'anoth':197 'api':113,175 'api-token-bas':174 'back':42,88 'base':177 'basic':218 'behind':252 'block':188 'build':153 'c':203,212 'callabl':24,70 'caveat':156 'claud':237,243 'cli':240 'client':99 'cloud':105,172 'cloudflar':190 'code':238 'codex':239 'comment':32,78 'compat':11,57,98 'coverag':170 'credenti':117 'cursor':241 'd':150 'databas':7,30,53,76 'desktop':244 'doc':263 'docker':148,160,195,207,216 'docs/configuration-and-deployment.md':254,255 'docs/getting-started.md':200,209 'document':5,29,51,75,267 'email/password':183 'end':166,168 'end-to-end':165 'environ':129 'exchang':274 'extract':260 'g':132 'get':222 'getting-start':221 'github.com':258,269 'github.com/dawncr0w/affine-mcp-server':257 'github.com/dawncr0w/affine-mcp-server/blob/main/docs/getting-started.md':268 'health':162 'host':109 'http':250 'imag':161,208,217 'includ':159 'insid':33,79 'instal':118,122 'instanc':110 'instead':37,83 'local':232 'match':127 'mcp':10,16,35,56,62,81,97,135,142,146,180,234 'mcp-compat':9,55,96 'need':21,67 'node.js':94 'note':224 'npm':130,151 'npx':137 'oauth':253 'oci':198 'p':139 'path':125,202,211 'path-c-run-from-the-docker-imag':201,210 'prerequisit':93 'probe':163 'programmat':182 'quick':225,228 'quick-start':227 'raw.githubusercontent.com':265 'raw.githubusercontent.com/dawncr0w/affine-mcp-server/head/readme.md':264 'remot':248 'requir':154,173 'run':149,152,191,204,213,230,245 'runtim':199 'save':116 'self':108 'self-host':107 'send':39,85 'server':17,63,136,143,193,235,247 'setup':124 'sign':185 'sign-in':184 'skill':273 'skill-work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents' 'sourc':256,271 'source-agentskillexchange' 'start':223,226,229 'stdio':233 'test':169 'token':114,176 'tool':23,69 'tool-cal':22,68 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-tools' 'topic-awesome-list' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-llm' 'topic-mcp' 'topic-npx-skills' 'topic-openclaw' 'topic-skills-catalog' 'ui':46,92 'upstream':121,158,262 'usag':181,219 'use':13,59,119 'user':41,87 'version':147 'work':1,47 'workflow':36,82 'workspac':4,28,50,74 'y':138","prices":[{"id":"95a65a14-597d-491e-b6e6-21830ae70cef","listingId":"3c767935-2c92-4bdf-9cab-2127b61dd052","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"agentskillexchange","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:20:22.446Z"}],"sources":[{"listingId":"3c767935-2c92-4bdf-9cab-2127b61dd052","source":"github","sourceId":"agentskillexchange/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents","isPrimary":false,"firstSeenAt":"2026-05-18T13:20:22.446Z","lastSeenAt":"2026-05-18T19:13:08.282Z"}],"details":{"listingId":"3c767935-2c92-4bdf-9cab-2127b61dd052","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents","github":{"repo":"agentskillexchange/skills","stars":8,"topics":["agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex","cursor","llm","mcp","npx-skills","openclaw","skills-catalog"],"license":"mit","html_url":"https://github.com/agentskillexchange/skills","pushed_at":"2026-05-18T19:02:17Z","description":"The open catalog of AI agent skills — 2,000+ security-scanned skills for Claude Code, Cursor, Codex, and more.","skill_md_sha":"339126a7c91a4af662a76b5abf8dfb7ef3153e33","skill_md_path":"skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"Work with AFFiNE workspaces, documents, and databases from MCP-compatible agents","description":"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."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/work-with-affine-workspaces-documents-and-databases-from-mcp-compatible-agents"},"updatedAt":"2026-05-18T19:13:08.282Z"}}