MDflow - online markdown editor

A markdown workspace that becomes a shared brain for you and your AI agents — 25 tools to read, write, organize, and share markdown documents at mdflow.cz.

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • Mdflow List Folders: List MDflow folders, each with its workspace_id and full path (workspace → … → folder). Folder descriptions are the primary context signal for the markdown documents inside each f
  • Mdflow Get Folder: Get one MDflow folder by id. Returns the folder's own description, its full path (workspace → … → folder), and its compounded_description: the labeled cascade of descriptions from t
  • Mdflow Create Folder: Create a new MDflow folder. If the requested name is already used, MDflow automatically adds a numeric suffix. Give the folder a clear description: descriptions drive topic retri

What data it sees

Do you need an account

No: the server works without sign-in

A markdown workspace that becomes a shared brain for you and your AI agents — 25 tools to read, write, organize, and share markdown documents at mdflow.cz.

Content is organized as workspaces → folders → documents, where every folder carries a description that defines the context for the documents inside it — so agents retrieve by meaning, not by filename.

What it does

  • Retrieve — semantic get_context ranks folder descriptions above names and titles and returns the best-matching document bodies; plus precise list/get across workspaces, folders, and documents.
  • Write — create, rename, move, and delete documents, folders, and workspaces; update bodies and folder/workspace descriptions.
  • Share — grant, list, and revoke per-document private (email) and public shares.

Ownership is enforced server-side: an agent only ever sees the authenticated user's workspace.

Connect — add https://mdflow.cz/api/mcp in Claude.ai or ChatGPT and sign in (OAuth, no token to paste), or authenticate with a Personal Access Token (Authorization: Bearer mdf_…) from mdflow.cz/settings. Requires MDflow Pro. Docs: mdflow.cz/docs/mcp

How to connect

How to connect MDflow - online markdown editor to Claude

The server address to paste into Claude settings:

https://mdflow.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect MDflow - online markdown editor to ChatGPT

The server address to paste into ChatGPT settings:

https://mdflow.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect MDflow - online markdown editor to Cursor

The server address to paste into Cursor settings:

https://mdflow.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (25)

Raw names from tools/list. Only developers need these.

mdflow_list_foldersList MDflow folders, each with its workspace_id and full path (workspace → … → folder). Folder descriptions are the primary context signal for the markdown documents inside each folder. Optionally filter to a single workspace.
mdflow_get_folderGet one MDflow folder by id. Returns the folder's own description, its full path (workspace → … → folder), and its compounded_description: the labeled cascade of descriptions from the workspace down through each ancestor folder to this folder — the assembled context for the documents inside.
mdflow_create_folderCreate a new MDflow folder. If the requested name is already used, MDflow automatically adds a numeric suffix. Give the folder a clear description: descriptions drive topic retrieval (mdflow_get_context).
mdflow_update_folder_descriptionReplace the description for one MDflow folder owned by the authenticated account. Descriptions are the primary retrieval signal for the documents inside the folder.
mdflow_rename_folderRename one MDflow folder owned by the authenticated account. If the destination already has a folder with the same name, MDflow automatically adds a numeric suffix.
mdflow_delete_folderDelete one MDflow folder and all documents inside it. This operation cannot be undone.
mdflow_move_folderReparent one MDflow folder: nest it under another folder owned by the authenticated account, or omit parent_id (or pass it as null) to move it to the top level. Moving a folder under itself or one of its own descendants is rejected. If the destination already has a folder with the same name, MDflow automatically adds a numeric suffix.
mdflow_list_workspacesList the workspaces owned by the authenticated account. Workspaces are the top-level bucket above folders; every folder belongs to exactly one workspace, and each workspace has its own name and description.
mdflow_create_workspaceCreate a new MDflow workspace. If the requested name is already used, MDflow automatically adds a numeric suffix. A workspace description is optional context describing what the workspace is for.
mdflow_rename_workspaceRename one MDflow workspace owned by the authenticated account. If the new name is already used by another workspace, MDflow automatically adds a numeric suffix.
mdflow_update_workspace_descriptionReplace the description for one MDflow workspace owned by the authenticated account. The description is free-text context describing what the workspace is for.
mdflow_delete_workspaceDelete one MDflow workspace and every folder and document inside it. This operation cannot be undone. You cannot delete your last workspace.
mdflow_list_documentsList MDflow documents, optionally limited to one folder or one workspace. Each document carries its workspace_id and full path (workspace → … → folder → document). Bodies are omitted; use mdflow_get_document to fetch one.
mdflow_get_documentGet one MDflow markdown document by ID — its body, its full path (workspace → … → folder → document), and its compounded_description: the workspace→folder context cascade for the document.
mdflow_create_documentCreate a markdown document inside an existing MDflow folder. If the requested title is already used in that folder, MDflow automatically adds a numeric suffix. Call mdflow_list_folders first to find the destination folder ID.
mdflow_rename_documentRename one MDflow document owned by the authenticated account. If the folder already has a document with the same title, MDflow automatically adds a numeric suffix.
mdflow_update_document_bodyReplace the markdown body for one MDflow document owned by the authenticated account. The previous body is overwritten entirely.
mdflow_move_documentMove one MDflow document to another folder owned by the authenticated account. If the target folder already has the same title, MDflow automatically adds a numeric suffix.
mdflow_update_document_sharingSet public link sharing and commenting options for one MDflow document. When enabled, the document becomes readable by anyone who has the unguessable share URL returned in the response. Only enable this when the user explicitly asks for a public or "anyone with the link" URL — it is never required in order to share with a specific person. To share with named people, use mdflow_add_document_share, which returns a private link and does not make the document public. Disabling sharing permanently invalidates the current link; re-enabling generates a new one. MDflow generates share slugs server-side.
mdflow_delete_documentDelete one MDflow document owned by the authenticated account. This operation cannot be undone.
mdflow_list_document_sharesList the people one MDflow document is privately shared with by email. Each share includes its ID (needed by mdflow_revoke_document_share), the invited email, whether commenting is allowed, and its status: "pending" until the recipient signs in to MDflow with that email, then "accepted". Public link sharing is separate — see mdflow_update_document_sharing.
mdflow_add_document_sharePrivately share one MDflow document with a person identified by email, optionally allowing them to comment. The response includes a private link ("link") to give the recipient; this grants access without making the document public, so do NOT enable public link sharing for this. MDflow does not send a notification email: the recipient opens that link (or finds the document under "Shared with me"), signs in to MDflow with that email address, and sees it. Sharing again with the same email updates the comment permission instead of creating a duplicate, and reactivates a previously revoked share. For an anyone-with-the-link public URL, use mdflow_update_document_sharing instead.
mdflow_revoke_document_shareRevoke one person's private access to an MDflow document. Use mdflow_list_document_shares first to find the share ID. Revocation takes effect immediately; the same email can be re-added later with mdflow_add_document_share.
mdflow_revoke_all_document_sharesRevoke private access to one MDflow document for every person it is shared with. Revocation takes effect immediately and is idempotent. This does not affect public link sharing — use mdflow_update_document_sharing for that.
mdflow_get_contextFind markdown context for a topic from MDflow. Use this when the user says 'Get information about <topic> from mdflow' or 'Use mdflow to get context about my <topic>'. Folder descriptions are ranked before document titles. When the topic clearly belongs to one workspace, first choose the most relevant workspace from mdflow_list_workspaces (match the topic against each workspace's name and description) and pass its id as workspaceId so retrieval stays inside that workspace. Omit workspaceId for broad or ambiguous topics that may span workspaces, or when only one workspace exists — it then ranks across the whole account.