Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
AppFlowy MCP server: edit Markdown, manage typed database rows, search and import/export.
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de AppFlowy MCP Server (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server AppFlowy MCP Server para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "appflowy": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "APPFLOWY_PASSWORD", "-e", "APPFLOWY_ACCESS_TOKEN", "ghcr.io/rahulk644/appflowy-mcp-server:2.2.0", "appflowy-mcp" ], "env": { "APPFLOWY_PASSWORD": "your-value", "APPFLOWY_ACCESS_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En APPFLOWY_PASSWORD, APPFLOWY_ACCESS_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de AppFlowy MCP Server aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"appflowy": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPFLOWY_PASSWORD",
"-e",
"APPFLOWY_ACCESS_TOKEN",
"ghcr.io/rahulk644/appflowy-mcp-server:2.2.0",
"appflowy-mcp"
],
"env": {
"APPFLOWY_PASSWORD": "your-value",
"APPFLOWY_ACCESS_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa AppFlowy MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando AppFlowy MCP Server o muestra una herramienta de AppFlowy MCP Server en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
APPFLOWY_BASE_URL Origen de AppFlowy Cloud o de un servidor autoalojado APPFLOWY_EMAIL Correo electrónico de la cuenta de bot dedicada (o usar un token de acceso) ALLOWED_WORKSPACE_IDS Lista de IDs de espacio de trabajo separados por comas a los que este servidor puede acceder APPFLOWY_READ_ONLY Desactiva las escrituras y expone herramientas de solo lectura Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar AppFlowy MCP Server
AppFlowy MCP Server se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar AppFlowy MCP Server
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de AppFlowy MCP Server (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server AppFlowy MCP Server para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user appflowy --env APPFLOWY_PASSWORD=your-value --env APPFLOWY_ACCESS_TOKEN=your-value -- docker run -i --rm -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN ghcr.io/rahulk644/appflowy-mcp-server:2.2.0 appflowy-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En APPFLOWY_PASSWORD, APPFLOWY_ACCESS_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de AppFlowy MCP Server aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user appflowy --env APPFLOWY_PASSWORD=your-value --env APPFLOWY_ACCESS_TOKEN=your-value -- docker run -i --rm -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN ghcr.io/rahulk644/appflowy-mcp-server:2.2.0 appflowy-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver AppFlowy MCP Server en la lista como conectado
Usa AppFlowy MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando AppFlowy MCP Server o muestra una herramienta de AppFlowy MCP Server en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
APPFLOWY_BASE_URL Origen de AppFlowy Cloud o de un servidor autoalojado APPFLOWY_EMAIL Correo electrónico de la cuenta de bot dedicada (o usar un token de acceso) ALLOWED_WORKSPACE_IDS Lista de IDs de espacio de trabajo separados por comas a los que este servidor puede acceder APPFLOWY_READ_ONLY Desactiva las escrituras y expone herramientas de solo lectura Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de AppFlowy MCP Server (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server AppFlowy MCP Server para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "appflowy": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "APPFLOWY_PASSWORD", "-e", "APPFLOWY_ACCESS_TOKEN", "ghcr.io/rahulk644/appflowy-mcp-server:2.2.0", "appflowy-mcp" ], "env": { "APPFLOWY_PASSWORD": "your-value", "APPFLOWY_ACCESS_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En APPFLOWY_PASSWORD, APPFLOWY_ACCESS_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de AppFlowy MCP Server aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de AppFlowy MCP Server, APPFLOWY_PASSWORD, APPFLOWY_ACCESS_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa AppFlowy MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando AppFlowy MCP Server o muestra una herramienta de AppFlowy MCP Server en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
APPFLOWY_BASE_URL Origen de AppFlowy Cloud o de un servidor autoalojado APPFLOWY_EMAIL Correo electrónico de la cuenta de bot dedicada (o usar un token de acceso) ALLOWED_WORKSPACE_IDS Lista de IDs de espacio de trabajo separados por comas a los que este servidor puede acceder APPFLOWY_READ_ONLY Desactiva las escrituras y expone herramientas de solo lectura Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de AppFlowy MCP Server (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server AppFlowy MCP Server para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "appflowy": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "APPFLOWY_PASSWORD", "-e", "APPFLOWY_ACCESS_TOKEN", "ghcr.io/rahulk644/appflowy-mcp-server:2.2.0", "appflowy-mcp" ], "env": { "APPFLOWY_PASSWORD": "your-value", "APPFLOWY_ACCESS_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En APPFLOWY_PASSWORD, APPFLOWY_ACCESS_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de AppFlowy MCP Server aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de AppFlowy MCP Server, APPFLOWY_PASSWORD, APPFLOWY_ACCESS_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa AppFlowy MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando AppFlowy MCP Server o muestra una herramienta de AppFlowy MCP Server en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
APPFLOWY_BASE_URL Origen de AppFlowy Cloud o de un servidor autoalojado APPFLOWY_EMAIL Correo electrónico de la cuenta de bot dedicada (o usar un token de acceso) ALLOWED_WORKSPACE_IDS Lista de IDs de espacio de trabajo separados por comas a los que este servidor puede acceder APPFLOWY_READ_ONLY Desactiva las escrituras y expone herramientas de solo lectura Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user appflowy --env APPFLOWY_PASSWORD=your-value --env APPFLOWY_ACCESS_TOKEN=your-value -- docker run -i --rm -e APPFLOWY_PASSWORD -e APPFLOWY_ACCESS_TOKEN ghcr.io/rahulk644/appflowy-mcp-server:2.2.0 appflowy-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"appflowy": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPFLOWY_PASSWORD",
"-e",
"APPFLOWY_ACCESS_TOKEN",
"ghcr.io/rahulk644/appflowy-mcp-server:2.2.0",
"appflowy-mcp"
],
"env": {
"APPFLOWY_PASSWORD": "your-value",
"APPFLOWY_ACCESS_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"appflowy": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPFLOWY_PASSWORD",
"-e",
"APPFLOWY_ACCESS_TOKEN",
"ghcr.io/rahulk644/appflowy-mcp-server:2.2.0",
"appflowy-mcp"
],
"env": {
"APPFLOWY_PASSWORD": "your-value",
"APPFLOWY_ACCESS_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"appflowy": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"APPFLOWY_PASSWORD",
"-e",
"APPFLOWY_ACCESS_TOKEN",
"ghcr.io/rahulk644/appflowy-mcp-server:2.2.0",
"appflowy-mcp"
],
"env": {
"APPFLOWY_PASSWORD": "your-value",
"APPFLOWY_ACCESS_TOKEN": "your-value"
}
}
}
}APPFLOWY_BASE_URL envAPPFLOWY_EMAIL envAPPFLOWY_PASSWORD secreto obligatorio envAPPFLOWY_ACCESS_TOKEN secreto obligatorio envALLOWED_WORKSPACE_IDS envAPPFLOWY_READ_ONLY envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 16 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub Rahulk644, dueña del repo
Último cambio de código: anteayer
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
No revisado: solo se pueden revisar paquetes npm y PyPI con versión
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: APPFLOWY_PASSWORD, APPFLOWY_ACCESS_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez anteayer, y la última versión (2.2.0) llegó al registro hace 6 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Anki MCP Server, Sosumi, Zapier
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
Search and read Apple developer documentation, HIG, and WWDC transcripts as Markdown.
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
An open-source AppFlowy MCP server (Model Context Protocol) for connecting Claude, Cursor, Codex and other MCP clients to your AppFlowy workspace. Give AI agents tools to edit Markdown documents, update typed database rows and Board cards, search pages, and import or export Markdown trees.
Run locally with uvx or Docker, or serve authenticated Streamable HTTP. The compact profile exposes 11 async workflow tools with typed inputs, bounded responses and explicit results for partial batch failures.
Independent community project; not affiliated with or endorsed by AppFlowy. The tested self-hosted baseline is Cloud 0.21.4 with Web 0.20.12. See compatibility and limitations before choosing a deployment.
Quick start · Client setup · Tools · Choosing a server · Compatibility
Requires Python 3.11+ and uv, or Docker. The commands below use the published 2.2.0 release. main can contain unreleased fixes; see CHANGELOG.md.
Create a private .env file with a dedicated AppFlowy bot account:
APPFLOWY_EMAIL=bot@example.com
APPFLOWY_PASSWORD=replace-with-the-bot-password ALLOWED_WORKSPACE_IDS=replace-with-workspace-id
An APPFLOWY_ACCESS_TOKEN can replace email/password. It takes precedence and must be replaced when it expires. .env.example lists all settings.
Run without cloning or creating a virtual environment:
uvx --from git+https://github.com/Rahulk644/Appflowy-MCP-Server@v2.2.0 \
appflowy-mcp --env-file /absolute/path/to/.env
Example Claude Desktop/Cursor-style configuration:
{
"mcpServers": { "appflowy": { "command": "uvx", "args": [ "--from", "git+https://github.com/Rahulk644/Appflowy-MCP-Server@v2.2.0", "appflowy-mcp", "--env-file", "/absolute/path/to/.env" ] } } }
Client recipes also cover Claude Code, Codex and Docker. Check configuration and workspace access with the same launcher:
uvx --from git+https://github.com/Rahulk644/Appflowy-MCP-Server@v2.2.0 \
appflowy-mcp doctor --check --env-file /absolute/path/to/.env
doctor without --check stays offline; --json produces a sanitized report.
The public image supports Linux amd64 and arm64. For stdio:
docker run --rm -i --env-file .env \
ghcr.io/rahulk644/appflowy-mcp-server:2.2.0 appflowy-mcp
For HTTP, add MCP_SECRET_TOKEN to .env and run:
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 \
ghcr.io/rahulk644/appflowy-mcp-server:2.2.0
The MCP endpoint is /mcp/; legacy SSE is /sse/. The image is listed in the official MCP Registry. PyPI publication is deferred. RELEASING.md covers publishing.
For a source-built service, configure .env and run docker compose up -d --build. The Compose file does not publish a port; connect it to your HTTPS reverse proxy. Traefik labels require an existing proxy and shared Docker network. The optional deploy_vps.sh starts the service; it does not provision public routing or TLS.
uvx command, local stdio and authenticated HTTP. No source checkout is required.| Task for your AI assistant | Relevant workflow |
|---|---|
| Find a project brief and append a meeting checklist | Search, fetch and Markdown update |
| Move an existing Board card to Done | Resolve the Status field, then update that row's cells |
| Build a tracker with dates and select fields | Create a database, configure fields and create typed rows |
| Read a card conversation and reply | Fetch comments by row ID, then append a reply |
| Export a project subtree as Markdown | Export complete files and follow returned continuations |
The compact profile exposes 11 async tools, or 12 with experimental AI enabled. Parameters are typed JSON inside request. Commands reject non-default inputs they cannot apply. For example, update_cells does not accept row document text, and database creation does not accept Markdown. Use the relevant document command instead; the validation error names unused fields.
| Tool | Purpose |
|---|---|
appflowy_search | Keyword search with server pagination |
appflowy_fetch | Workspaces, folders, page metadata/Markdown, database fields and comments |
appflowy_create_pages | Batch documents, spaces, databases and database views |
appflowy_update | Page operations, Markdown edits, comment appends and space permissions |
appflowy_delete | Page trash; row, block and field deletion |
appflowy_database | Fields, options, grouping, Formula expressions and Timeline settings |
appflowy_rows | Bounded reads and typed batch create/upsert/update/delete |
appflowy_blocks | Markdown/advanced blocks, inline edits and text replacement |
appflowy_import | Markdown trees, small base64 files and optional image insertion |
appflowy_export | Bounded Markdown page/tree export |
appflowy_api | Additional workspace-relative REST routes |
appflowy_ai (opt-in) | Experimental AppFlowy chat with explicit context |
{"request":{"workspace_id":"WORKSPACE_ID","database_id":"DATABASE_ID","command":"update_cells","rows":[{"row_id":"ROW_ID","cells":{"Name":"Updated task","Done":true}}]}}
Follow returned next_offset values rather than adding the requested limit: a response may contain fewer complete items to fit its budget. Markdown reads use character offsets and a content hash; folder reads can target an id. Tree export returns complete files, a tree cursor, and fetch instructions for oversized documents. See the continuation contract.
APPFLOWY_TOOL_PROFILE=legacy exposes 36 tools: the original 34 names plus two comment tools. APPFLOWY_READ_ONLY=true exposes five read-only tools in compact mode and rejects API mutations. Profiles are exclusive. Read the migration table and agent guide, also available as appflowy://guide. Manifest measurements measure bytes, not LLM accuracy.
| Setting | Behavior |
|---|---|
APPFLOWY_EMAIL / APPFLOWY_PASSWORD | Dedicated account login with automatic token refresh |
APPFLOWY_ACCESS_TOKEN | Alternative AppFlowy access token; no automatic renewal |
APPFLOWY_BASE_URL | AppFlowy origin; defaults to https://beta.appflowy.cloud |
APPFLOWY_PUBLIC_URL | Optional browser-facing origin for returned file/image URLs; uploads still use APPFLOWY_BASE_URL |
ALLOWED_WORKSPACE_IDS | Comma-separated server-wide workspace allow-list |
APPFLOWY_TOOL_PROFILE | compact (default) or legacy |
APPFLOWY_READ_ONLY | Disable writes; compact read-only schemas |
APPFLOWY_ENABLE_AI | Opt into experimental AI on a configured deployment |
MCP_SECRET_TOKEN | HTTP shared secret, sent as Authorization: Bearer ... |
MCP_ALLOWED_HOSTS / MCP_ALLOWED_ORIGINS | Explicit public host/origin when proxied; include custom ports |
GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET | Optional Google OAuth credentials |
ALLOWED_EMAILS / OAUTH_ISSUER | OAuth email allow-list and public HTTPS origin |
OAUTH_STORE_PATH | Private JSON token store on a persistent volume |
For an installed command, appflowy-mcp --transport streamable-http listens on 127.0.0.1:8000; --host and --port change the bind address. Source checkouts also support python server.py and uvicorn server:app.
For Google OAuth, register a Google Web client with redirect URI https://YOUR_HOST/auth/google/callback, configure the OAuth settings above, and connect the MCP client to https://YOUR_HOST/mcp/. For shared-secret clients:
{"mcpServers":{"appflowy":{"url":"https://mcp.example.com/mcp/","headers":{"Authorization":"Bearer YOUR_MCP_SECRET_TOKEN"}}}}
The ?token=... URL form is supported for clients without header support; URLs can leak through proxies, logs and browser history. Prefer headers or OAuth.
All HTTP users act through the same AppFlowy account and server-wide workspace policy. OAuth identifies clients; it does not grant each client a separate AppFlowy role or page-subtree scope. Protect remote HTTP with authentication and HTTPS. See SECURITY.md.
An AppFlowy MCP server translates requests from an MCP client into AppFlowy operations. This community server uses AppFlowy's REST and collaboration APIs to read and edit documents, database schemas, rows and blocks. It is MIT licensed and is not an official AppFlowy product.
Yes, through their MCP configuration. Use local stdio for a client-launched process or Streamable HTTP for a running service. Copy the client-specific recipes. Automated checks cover the MCP protocol and packaged server; individual desktop interfaces are not certified.
AppFlowy also provides its own MCP service and AI app plugins. Choose based on the deployment and access model your workflow needs:
| Requirement | This community server | AppFlowy's official MCP |
|---|---|---|
| Local process | Native stdio through uvx or Docker; HTTP is also available | The official guide describes an HTTP service with AppFlowy sign-in |
| Identity and access | One configured bot account; server-wide workspace allow-list and read-only mode | User sign-in, a workspace per connection, and read/write/admin scopes |
| Managed team connections | HTTP shared secret or optional Google OAuth; every approved client uses the same bot | Workspace app approvals, per-device disconnects and administrator policies |
| Main workflows | Eleven grouped tools for Markdown, typed rows, comments, small uploads and bounded import/export | The published catalog also includes dedicated forms, reminders, saved filters and Chart/Dashboard controls |
| Self-hosted requirements | An AppFlowy account with the needed API permissions; no separate MCP license key | The official self-hosted MCP