AppFlowy MCP Server

An open-source Model Context Protocol server for AppFlowy Cloud — so AI agents can read, build, and finish work in your AppFlowy workspace.

Not just view a Kanban board: create databases and pages, move cards, edit and delete rows, and edit document blocks (including advanced ones like callouts and toggles) — all over a single endpoint that’s scoped to exactly the workspaces you choose and gated by Google OAuth or a token.

ℹ️ Independent community project — not affiliated with or endorsed by AppFlowy. It talks to the public AppFlowy Cloud API with an account you control.

✨ Highlights

• Full CRUD, not read-only. Create pages/databases/fields/rows, and — via a collaborative-editing (CRDT) layer — edit, move, and delete any existing row or document block, including ones made by hand in the UI.
• Advanced blocks the REST API can’t make. Callouts, toggles, quotes, code, columns, and more, placed programmatically.
• Scoped by design. ALLOWED_WORKSPACE_IDS makes every tool refuse anything outside your allow-list — even if the account can see more.
• Three ways to connect. Google OAuth sign-in, a Bearer header token, or a token-in-URL link for UIs that can’t set headers. Works with Claude, Cursor, Antigravity, and any MCP client.
• Agent-ready. Ships an AppFlowy “knowledge pack” as MCP server instructions and a fetchable appflowy://guide resource (see KNOWLEDGE.md) so agents build clean, well-formed structures.
• Batteries included. stdio / Streamable-HTTP / SSE transports, Docker, tests, and CI.

🧰 Tools

Read — get_workspaces, get_workspace_folder, list_databases, get_database_fields, get_database_row_ids, get_database_row_details, get_page, get_page_markdown (page/card body as Markdown), list_updated_rows

Create & structure (plain JSON, no CRDT) — create_page, create_database (grid/board/calendar), create_database_view, add_database_field, create_database_row, upsert_database_row, append_blocks, create_space, move_page, duplicate_page, rename_page, trash_page, restore_page