docflows-mcp

An MCP server that lets Claude Code (and other MCP clients) read and write DocFlows documents, folders and pages through the docflows-api edge function.

1. Get an API key

In the DocFlows web app: profile picture (bottom-left) → Account → API Keys → Create Key. Choose the workspaces and permissions the key should have. Copy the key (dfk_user_…) — it is shown only once.

2. Install deps

cd mcp
npm install

3. Add to Claude Code

claude mcp add docflows \
  --env DOCFLOWS_API_KEY=dfk_user_your_key_here \
  -- node /absolute/path/to/docflows_md/mcp/src/index.js

Once published to npm you can instead use -- npx -y docflows-mcp.

Optional env var DOCFLOWS_API_URL overrides the API base (defaults to the hosted docflows-api function, ending in /v1).

Tools

| Tool | Purpose | |------|---------| | list_workspaces | Workspaces this key can access | | list_folders / create_folder / rename_folder / delete_folder | Manage folders | | list_documents / get_document / search_documents | Browse documents | | create_document / update_document / move_document / delete_document | Manage documents | | list_pages / create_page / update_page / delete_page | Manage a document's pages |

get_document returns the document plus all its pages (with content_markdown). A document's body lives on its pages — use update_page to change content.

Content is rendered as HTML by the editor, so send HTML or plain text (not raw Markdown).