appflowy-mcp

# AppFlowy MCP An MCP server and CLI for [AppFlowy](https://github.com/appflowy-io/appflowy) with 73 tools covering workspaces, spaces, pages, page content, Markdown import and export, databases, rows, search, members and invitations, publishing, quick notes, file upload, and AI chat. ## Requirements - Python 3.14 - uv - AppFlowy account credentials ## Installation The package is published on PyPI as [`appflowy-mcp`](https://pypi.org/project/appflowy-mcp/), so all clients can run it with `uvx appflowy-mcp`. Pick your client below. ### Claude Code ```bash claude mcp add appflowy \ -e APPFLOWY_EMAIL=your-email \ -e APPFLOWY_PASSWORD=your-password \ -- uvx appflowy-mcp ``` ### Codex ```bash codex mcp add appflowy \ --env APPFLOWY_EMAIL=your-email \ --env APPFLOWY_PASSWORD=your-password \ -- uvx appflowy-mcp ``` ### Other MCP Clients Any client that supports stdio MCP servers can use this JSON config (Claude Desktop, Cursor, Windsurf, etc.): ```json { "mcpServers": { "appflowy": { "command": "uvx", "args": ["appflowy-mcp"], "env": { "APPFLOWY_EMAIL": "your-email", "APPFLOWY_PASSWORD": "your-password" } } } } ``` ### Local Source (Development) When developing from a cloned repository, replace `uvx appflowy-mcp` with `uv run` against your checkout. For example with Claude Code: ```bash claude mcp add appflowy \ -e APPFLOWY_EMAIL=your-email \ -e APPFLOWY_PASSWORD=your-password \ -- uv run --project /path/to/appflowy_mcp appflowy-mcp ``` ## Environment Variables Set these environment variables: ```text APPFLOWY_EMAIL=your-email@example.com APPFLOWY_PASSWORD=your-password ``` With these variables set, tools automatically log in on first use. `appflowy_login` is still available when you want to provide credentials explicitly. For self-hosted AppFlowy, also set the base URL: ```text APPFLOWY_BASE_URL=http://localhost:8000 ``` If omitted, `APPFLOWY_BASE_URL` defaults to `https://beta.ap…