# wisflux/docmost-local-mcp [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/wisflux/docmost-local-mcp  
**GitHub Stars:** 9  
**npm Downloads (last month):** 183  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/wisflux-docmost-local-mcp

## Description
MCP server for self-hosted Docmost (an open-source Notion/Confluence alternative). Read and write spaces, pages, comments, and members from Claude, Cursor, or VS Code. Works on the free Community Edition. npx -y @wisflux/docmost-local-mcp

## Tools
Capabilities this server exposes over MCP:

- **list_spaces** — list available Docmost spaces
- **get_space** — fetch details for a specific space
- **search_docs** — search documentation, optionally scoped to a space
- **search_pages** — backward-compatible alias for `search_docs`
- **get_page** — fetch a page and return its content as Markdown
- **list_pages** — list recent pages in a space
- **list_child_pages** — list child pages for a parent page ID
- **get_comments** — list comments for a page
- **list_workspace_members** — list workspace members
- **get_current_user** — fetch the authenticated user and workspace context
- **create_page** — create a new page in a space from Markdown content
- **update_page** — update an existing page's title and/or Markdown content
- **duplicate_page** — duplicate a page (and its sub-pages) within its space
- **copy_page_to_space** — copy a page (and its sub-pages) into a different space
- **move_page** — move a page under a new parent page, or to the space root
- **move_page_to_space** — move a page (and its sub-pages) to a different space
- **create_space** — create a new space with a name and URL slug
- **update_space** — update a space's name, slug, and/or description
- **create_comment** — add a page-level comment to a page from Markdown
- **update_comment** — replace an existing comment's body with new Markdown

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "docmost-local-mcp": {
    "command": "npx",
    "args": ["-y","@wisflux/docmost-local-mcp"]
  }
}
```

## Documentation

## What wisflux/docmost-local-mcp MCP server does

wisflux/docmost-local-mcp MCP server gives AI clients a local stdio connection to a self-hosted Docmost installation. It supports both read and write operations across spaces, pages, comments, workspace members, and the authenticated user context. The package is intended for Docmost deployments using the Community Edition and does not require an enterprise license according to the provided project description.

Read operations include listing spaces, retrieving space details, searching documentation, fetching page content as Markdown, listing recent or child pages, reading page comments, listing workspace members, and checking the current user and workspace. Write operations cover creating and updating spaces, creating and updating pages, adding or replacing page-level comments, duplicating pages, copying pages between spaces, and moving pages within or across spaces.

## How it works

The npm entrypoint starts a Rust binary that handles MCP stdio traffic, local authentication, session handling, and calls to the Docmost API. On the first authenticated tool call, it starts a local login page on `127.0.0.1`. A native authentication window is used when supported; otherwise, the system browser opens. Login uses the Docmost instance URL, email, and password.

After authentication, the server extracts the Docmost `authToken` cookie and reuses the saved session until the token is near expiration or rejected. The server checks the Docmost version once per session and adjusts behavior for supported version differences. It targets roughly the last year of Docmost releases, with stated support beginning around v0.22.

## Setup and configuration

wisflux/docmost-local-mcp MCP server requires Node.js 18 or newer, a reachable Docmost instance, and email/password authentication enabled in that instance. Run it with `npx -y @wisflux/docmost-local-mcp`. The Docmost URL can be supplied with `--base-url=https://docs.example.com` or through `DOCMOST_BASE_URL`. If neither is supplied, the interactive login flow asks for the URL.

MCP clients configure the server as a local stdio process using `npx` and the package name. Claude Desktop uses its `claude_desktop_config.json`; Cursor uses a global or project `.cursor/mcp.json`; and VS Code GitHub Copilot uses `.vscode/mcp.json` with a top-level `servers` key. The README also documents a direct Claude Code registration command.

Local state is stored under `~/.docmost-local-mcp/`. The state includes the last base URL and email, plus the saved session token and expiry. Credentials use the operating system keychain when available. If that storage is unavailable, the server uses encrypted local credential storage rather than plain-text credentials.

## Tools and capabilities

The tool set supports:

- Space discovery and management with `list_spaces`, `get_space`, `create_space`, and `update_space`.
- Documentation search through `search_docs`, with `search_pages` retained as an alias.
- Page retrieval, listing, creation, editing, duplication, copying, and moving.
- Comment listing, creation, and body replacement.
- Workspace member listing and current-user lookup.
- Markdown page and comment bodies, including links, lists, code blocks, and other documented formatting. Pages additionally support tables and external image URLs.
- User and page mentions through `user:` and `page:` links in Markdown.

## Limitations and notes

Page body updates require Docmost v0.70.0 or newer. On older versions, title changes work, but REST body updates may be ignored; the server reports this behavior and recommends page creation for persisted bodies. Inline comments attached to text selections are outside the REST-based implementation. Uploaded files and images are not supported, although pages can reference external image URLs. Native authentication depends on platform components: Windows needs WebView2, and Linux desktop environments need WebKitGTK. Browser fallback is available when the native webview is unavailable.

_Full upstream README: https://allmcps.com/mcp/wisflux-docmost-local-mcp/readme_