appflowy-mcp 0.1.0

AppFlowy Cloud MCP server for workspace, space, page, database, and row operations

AppFlowy MCP

An MCP server for AppFlowy Cloud. This fork adds workspace folder, space, page, trash, favorite, and basic page-content tools on top of the original workspace/database/row tools.

Requirements

• Python 3.14
• uv
• AppFlowy Cloud account credentials

Configure In Codex

After publishing to PyPI, use uvx as the command:

uvx

Use these arguments:

appflowy-mcp

Set these environment variables:

APPFLOWY_EMAIL=[e-mail]
APPFLOWY_PASSWORD=your-password
FASTMCP_SHOW_SERVER_BANNER=false
FASTMCP_CHECK_FOR_UPDATES=off
FASTMCP_LOG_ENABLED=false

The FastMCP variables keep stdio clean for MCP handshakes.

AppFlowy Structure

Most write operations need both a workspace and a parent view:

workspace -> space -> page/database

To create a page inside a space, pass the workspace ID and use the space view_id as parent_view_id.

Tools

Authentication

• appflowy_login
• appflowy_refresh_token

Workspaces And Spaces

• appflowy_list_workspaces
• appflowy_get_workspace_folder
• appflowy_list_spaces
• appflowy_create_space
• appflowy_update_space

Pages

• appflowy_create_page
• appflowy_get_page
• appflowy_update_page
• appflowy_move_page_to_trash
• appflowy_restore_page_from_trash
• appflowy_delete_page_from_trash
• appflowy_favorite_page
• appflowy_list_trash
• appflowy_list_favorites

Page Content

• appflowy_append_text_to_page
• appflowy_append_blocks_to_page

Page-content support currently covers appending new document blocks. AppFlowy Cloud exposes a high-level append-block endpoint, but not a matching high-level REST endpoint for deleting or editing arbitrary existing blocks. Page-level deletion through trash is supported.

Example paragraph block:

{
  "type": "paragraph",
  "data": {
    "delta": [
      {
        "insert": "Hello from MCP"
      }
    ]
  }
}

Databases And Rows

• appflowy_list_databases
• appflowy_get_database_fields
• appflowy_list_rows
• appflowy_get_row_details
• appflowy_create_row
• appflowy_upsert_row
• appflowy_get_updated_rows

Local Run

uv run appflowy-mcp

Notes

• Tokens are stored in memory by the MCP server process.
• APPFLOWY_EMAIL and APPFLOWY_PASSWORD can also be provided through a local .env file.
• Some page and space endpoints are implemented from AppFlowy Cloud source routes that are not present in the public OpenAPI document.