# AppFlowy MCP Server

MCP server for Claude Code and Cursor that connects AI agents to your AppFlowy workspace. Runs locally via Docker or uvx before starting a session with environment variables.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 repo stars
- Author: Rahulk644
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Rahulk644/Appflowy-MCP-Server
- Updated: 2026-11-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/appflowy-mcp-server

## What it does

AppFlowy MCP Server connects AI assistants to your AppFlowy workspace to edit Markdown documents, manage typed database rows, board cards, and pages. The server exposes 11 async tools for keyword search, batch record creation, and importing or export of document trees.

Operation requires an AppFlowy bot account, workspace identifiers, and credentials via email and password or an `APPFLOWY_ACCESS_TOKEN`. Without a configured `.env` file granting workspace access, the server rejects incoming connections.

The package supports local stdio transport or an authenticated HTTP service. The configuration uses Docker images or the `uvx` launcher with a built-in doctor command for diagnostics.

Tested against the self-hosted Cloud 0.21.4 and Web 0.20.12 baseline.

## Requirements
- Needs: Docker
- Environment variables: `APPFLOWY_BASE_URL`, `APPFLOWY_EMAIL`, `APPFLOWY_PASSWORD`, `APPFLOWY_ACCESS_TOKEN`, `ALLOWED_WORKSPACE_IDS`, `APPFLOWY_READ_ONLY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> --env APPFLOWY_EMAIL=<APPFLOWY_EMAIL> --env APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> --env APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> --env ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> --transport stdio appflowy-mcp-server -- docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add appflowy-mcp-server --env APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> --env APPFLOWY_EMAIL=<APPFLOWY_EMAIL> --env APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> --env APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> --env ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> -- docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "appflowy-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "APPFLOWY_BASE_URL",
                "-e",
                "APPFLOWY_EMAIL",
                "-e",
                "APPFLOWY_PASSWORD",
                "-e",
                "APPFLOWY_ACCESS_TOKEN",
                "-e",
                "ALLOWED_WORKSPACE_IDS",
                "ghcr.io/rahulk644/appflowy-mcp-server:2.2.0"
            ],
            "env": {
                "APPFLOWY_BASE_URL": "<APPFLOWY_BASE_URL>",
                "APPFLOWY_EMAIL": "<APPFLOWY_EMAIL>",
                "APPFLOWY_PASSWORD": "<APPFLOWY_PASSWORD>",
                "APPFLOWY_ACCESS_TOKEN": "<APPFLOWY_ACCESS_TOKEN>",
                "ALLOWED_WORKSPACE_IDS": "<ALLOWED_WORKSPACE_IDS>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "appflowy-mcp-server": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "APPFLOWY_BASE_URL",
                "-e",
                "APPFLOWY_EMAIL",
                "-e",
                "APPFLOWY_PASSWORD",
                "-e",
                "APPFLOWY_ACCESS_TOKEN",
                "-e",
                "ALLOWED_WORKSPACE_IDS",
                "ghcr.io/rahulk644/appflowy-mcp-server:2.2.0"
            ],
            "env": {
                "APPFLOWY_BASE_URL": "<APPFLOWY_BASE_URL>",
                "APPFLOWY_EMAIL": "<APPFLOWY_EMAIL>",
                "APPFLOWY_PASSWORD": "<APPFLOWY_PASSWORD>",
                "APPFLOWY_ACCESS_TOKEN": "<APPFLOWY_ACCESS_TOKEN>",
                "ALLOWED_WORKSPACE_IDS": "<ALLOWED_WORKSPACE_IDS>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e APPFLOWY_BASE_URL=<APPFLOWY_BASE_URL> -e APPFLOWY_EMAIL=<APPFLOWY_EMAIL> -e APPFLOWY_PASSWORD=<APPFLOWY_PASSWORD> -e APPFLOWY_ACCESS_TOKEN=<APPFLOWY_ACCESS_TOKEN> -e ALLOWED_WORKSPACE_IDS=<ALLOWED_WORKSPACE_IDS> appflowy-mcp-server docker run -i --rm -e APPFLOWY_BASE_URL -e APPFLOWY_EMAIL -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN -e ALLOWED_WORKSPACE_IDS ghcr.io/rahulk644/appflowy-mcp-server:2.2.0
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- edit Markdown documents and pages
- update typed database rows and board cards
- search workspace pages by keywords
- export and import document trees

## Example prompts
- Find the project brief in AppFlowy and append the task checklist
- Move an existing board card to Done status
- Create a database with tracking fields and add typed rows

## Similar
- [Obsidian MCP Server](https://affpapa.org/en/nevibecode/mcp/maxkuminov-obsidian-mcp-server.md) — MCP server · ★ 20 repo stars
- [weave](https://affpapa.org/en/nevibecode/mcp/weave.md) — MCP server · ★ 19 repo stars
- [sqlite-graph-memory](https://affpapa.org/en/nevibecode/mcp/sqlite-graph-memory.md) — MCP server · ★ 17 repo stars
- [WireCat notion](https://affpapa.org/en/nevibecode/mcp/wirecat-notion.md) — MCP server · ★ 1 repo stars
- [notion](https://affpapa.org/en/nevibecode/skills/notion.md) — skill · 5700 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 440900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
