List all available AFFiNE workspaces

Get details of a specific workspace

Create a new workspace with initial document (accessible in UI)

Update workspace settings

Delete a workspace permanently

List documents in a workspace (GraphQL).

Fast search for documents by title using workspace metadata. Much faster than exporting each doc. Returns docId, title, and direct URL for each match.

List all tags in a workspace and the number of docs attached to each tag.

List documents that contain the requested tag.

Create a workspace-level tag entry for future reuse.

Add a tag to a document.

Remove a tag from a document.

Get a document by ID (GraphQL metadata).

Read document block content via WebSocket snapshot (blocks + plain text). Set includeMarkdown: true to also get the rendered markdown — useful when you need to read content without a separate export_doc_markdown call.

Return machine-readable capability flags for this MCP server, including block, database, collaboration, and export support.

Inspect a document for markdown export fidelity risk, including unsupported AFFiNE block flavours and risky content paths.

Move a doc in the AFFiNE sidebar by embedding it under a new parent. Optionally removes it from the old parent (fromParentDocId). If fromParentDocId is omitted, the doc is added to the new parent but not removed from the old one.

Publish a doc (make public).

Revoke a doc's public access.

Create a new AFFiNE document with optional content. If parentDocId is provided, the new doc is linked into the sidebar tree immediately.

Create an AFFiNE-native page with intentional section structure and native block composition.

Append a semantic section to an existing AFFiNE document by heading title and native block composition.

Append document blocks with canonical types and legacy aliases (supports placement + strict validation).

Export AFFiNE document content to markdown.

Export document markdown together with a structured fidelity report that highlights markdown loss risk and unsupported AFFiNE-native content.

Create a new AFFiNE document and import markdown content. Use parentDocId to automatically embed the new doc into a parent, making it visible in the sidebar instead of being an orphan.

Append markdown content to an existing AFFiNE document.

Replace the main note content of a document with markdown content.

Delete a document and remove from workspace list

Returns the full document hierarchy as a tree (roots → children → grandchildren). Use depth to limit nesting (default: 3). Note: loads all docs — may be slow on large workspaces.

Find all documents that have no parent (not linked from any other doc via embed_linked_doc). Useful for workspace hygiene. Note: scans all docs — O(n).

List the direct children of a document in the sidebar (embed_linked_doc blocks). Returns docId, title, and URL for each child.

Rename a document — updates both the sidebar title (workspace metadata) and the doc's internal page block title.

Inspect a template doc's native structure, tags, and fallback risk before instantiation.

Instantiate a template using native AFFiNE block cloning when supported, falling back to markdown materialization only when necessary.

Add a row to an AFFiNE database block. Provide cell values mapped by column name or column ID. Title column text is stored on the row paragraph block. Select columns auto-create options by label.

Delete a row from an AFFiNE database block.

Read row titles and database cell values from an AFFiNE database block.

Read schema metadata for an AFFiNE database block, including columns, select options, and view column mappings. Useful for empty databases before any rows exist.

Batch update multiple cells on an existing AFFiNE database row. Include title in the cells map to update the Kanban row title.

Create a useful AFFiNE database/data-view from declarative intent. Supports task_board and issue_tracker presets with starter schema, kanban view, and optional starter rows.

Add a column to an existing AFFiNE database block. Supports rich-text, select, multi-select, number, checkbox, link, date types.

Add a shape, connector, text, or group to the AFFiNE edgeless canvas surface. Shapes support rect/ellipse/diamond/triangle with fill, stroke, and text. Connectors draw arrows between shapes (by id) or between absolute points. Use for building diagrams programmatically. Style fields that don't apply to the chosen element type are reported in the response 'ignored' list (mirrors update_surface_element).

List all shape/connector/text/group elements on the AFFiNE edgeless canvas surface. Returns raw xywh strings plus parsed {x,y,width,height} bounds, with Y.Text fields serialized to plain strings. Optional filters by element type or id.

Partially update a surface element by id. x/y/width/height merge with the element's current xywh (move without resizing, or vice versa). text/label/title replace their Y.Text wholesale. Fields that don't apply to the element's type are reported in the response 'ignored' list.

Delete a surface element by id. Set pruneConnectors=true to also delete any connectors whose source or target referenced the deleted element.

Replace a frame block's contents wholesale. Accepts ids of surface elements (shapes/connectors/groups) AND edgeless blocks (notes/frames/edgeless-text) — all go into BlockSuite's prop:childElementIds map, matching what the editor writes when you drag members into a frame. Dragging the frame drags every owned member. Ids that don't resolve come back under 'missing'. By default the frame is resized to fit its new contents (plus padding + title band); set resizeToFit=false to leave xywh untouched. Pass [] to clear ownership (resize is skipped in that case).

Partially update a note/frame/edgeless-text block by id. x/y/width/height merge with current prop:xywh (move without resizing, or vice versa). background replaces prop:background (AFFiNE token or {light, dark} hex object). Fields that don't apply to the block's flavour come back under ignored.

Delete a block by id. Removes descendants and unlinks from the parent's sys:children by default; set deleteChildren=false to keep descendants orphaned (for re-parenting), or pruneConnectors=true to also drop surface connectors referencing any deleted id. Refuses affine:page — use delete_doc for whole docs.

Read the full edgeless canvas: all edgeless-positioned blocks (notes, frames, edgeless-text) with their xywh, plus all surface elements (shapes, connectors, text, groups). Includes aggregate bounding box and per-type element counts. Use this when you need to understand canvas layout end-to-end before placing new elements.

List comments of a doc (with replies).

Create a comment on a doc.

Update a comment content.

Delete a comment by id.

Resolve or unresolve a comment.

List doc histories (timestamps) for a doc.

List AFFiNE collections stored in the workspace sidebar.

Get an AFFiNE collection by id.

Create a new AFFiNE collection in the workspace sidebar.

Replace a collection's rules and rebuild its allow-list from workspace docs.

Rename an AFFiNE collection.

Delete an AFFiNE collection from the workspace sidebar.

Add a document id to an AFFiNE collection allow-list.

Remove a document id from an AFFiNE collection allow-list.

Experimental: list AFFiNE sidebar organize nodes from the folders workspace DB.

Experimental: create an AFFiNE organize folder node.

Create a simple workspace folder blueprint under the organize tree.

Experimental: rename an AFFiNE organize folder node.

Experimental: delete an AFFiNE organize folder and all nested nodes.

Experimental: move an AFFiNE organize folder or link node.

Experimental: add a doc/tag/collection link under an AFFiNE organize folder.

Experimental: delete an AFFiNE organize doc/tag/collection link.

Get current signed-in user.

Update current user's profile information.

Update user settings and preferences.

Sign in to AFFiNE using email and password; sets session cookies for subsequent calls.

List personal access tokens (metadata).

Generate a personal access token (returns token).

Revoke a personal access token by id.

Upload a file or blob to workspace storage.

Delete a blob/file from workspace storage.

Permanently remove deleted blobs to free up storage.

Get user notifications.

Mark all notifications as read.