appflowy-mcp 0.1.0__tar.gz

appflowy_mcp-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+.venv 
+README.md
+__pycache__
+.env
+.idea
+dist/
+build/
+*.egg-info/

appflowy_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

appflowy_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: appflowy-mcp
+Version: 0.1.0
+Summary: AppFlowy Cloud MCP server for workspace, space, page, database, and row operations
+Project-URL: Homepage, https://github.com/weironz/appflowy_mcp
+Project-URL: Repository, https://github.com/weironz/appflowy_mcp
+Requires-Python: <3.15,>=3.14
+Requires-Dist: appflowysdk>=0.1.2
+Requires-Dist: fastmcp>=3.1.1
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: python-dotenv>=1.2.2
+Description-Content-Type: text/markdown
+
+# 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:
+
+```text
+uvx
+```
+
+Use these arguments:
+
+```text
+appflowy-mcp
+```
+
+Set these environment variables:
+
+```text
+APPFLOWY_EMAIL=your-email@example.com
+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:
+
+```text
+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:
+
+```json
+{
+  "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
+
+```bash
+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.

appflowy_mcp-0.1.0/README.md

@@ -0,0 +1,116 @@
+# 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:
+
+```text
+uvx
+```
+
+Use these arguments:
+
+```text
+appflowy-mcp
+```
+
+Set these environment variables:
+
+```text
+APPFLOWY_EMAIL=your-email@example.com
+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:
+
+```text
+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:
+
+```json
+{
+  "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
+
+```bash
+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.

appflowy_mcp-0.1.0/appflowy_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""AppFlowy MCP server package."""
+
+__all__ = ["server"]

appflowy_mcp-0.1.0/appflowy_mcp/__main__.py

@@ -0,0 +1,5 @@
+from .server import main
+
+
+if __name__ == "__main__":
+    main()

appflowy_mcp-0.1.0/appflowy_mcp/models.py

@@ -0,0 +1,103 @@
+from pydantic import BaseModel
+from typing import Optional, Dict, Any, List
+
+# AppFlowy Cloud Models
+
+
+class LoginRequest(BaseModel):
+    email: Optional[str] = None
+    password: Optional[str] = None
+
+
+class RefreshTokenRequest(BaseModel):
+    refresh_token: str
+
+
+class AuthResponse(BaseModel):
+    access_token: str
+    token_type: str
+    expires_in: int
+    refresh_token: str
+
+
+class Workspace(BaseModel):
+    id: str
+    name: str
+    database_id: Optional[str] = None
+
+
+class Database(BaseModel):
+    id: str
+    name: str
+    workspace_id: str
+
+
+class RowDetail(BaseModel):
+    id: str
+    cells: Dict[str, Any]
+    document: Optional[str] = None
+
+
+class RowCreateRequest(BaseModel):
+    cells: Dict[str, Any]
+    document: Optional[str] = None
+
+
+class RowUpdateRequest(BaseModel):
+    pre_hash: Optional[str] = None
+    cells: Dict[str, Any]
+    document: Optional[str] = None
+
+
+class CreateSpaceRequest(BaseModel):
+    name: str
+    space_permission: int = 0
+    space_icon: str = "interface_essential/home-3"
+    space_icon_color: str = "0xFFA34AFD"
+    view_id: Optional[str] = None
+
+
+class UpdateSpaceRequest(BaseModel):
+    name: str
+    space_permission: int = 0
+    space_icon: str = "interface_essential/home-3"
+    space_icon_color: str = "0xFFA34AFD"
+
+
+class CreatePageRequest(BaseModel):
+    parent_view_id: str
+    name: Optional[str] = None
+    layout: int = 0
+    page_data: Optional[Dict[str, Any]] = None
+    view_id: Optional[str] = None
+    collab_id: Optional[str] = None
+
+
+class UpdatePageRequest(BaseModel):
+    name: str
+    icon: Optional[Dict[str, Any]] = None
+    is_locked: Optional[bool] = None
+    extra: Optional[Dict[str, Any]] = None
+
+
+class FavoritePageRequest(BaseModel):
+    is_favorite: bool = True
+    is_pinned: bool = False
+
+
+class AppendBlocksRequest(BaseModel):
+    blocks: List[Dict[str, Any]]
+
+
+class AppendTextRequest(BaseModel):
+    texts: List[str]
+    block_type: str = "paragraph"
+
+
+# Todoist Models (existing)
+class Task(BaseModel):
+    id: str | None = None
+    content: str
+    description: str
+    project_id: str | None = None
+    priority: int