Log inSubmit server
Docmost Local MCP logo

Docmost Local MCP

by wisflux

Connects local AI clients to self-hosted Docmost for searching, reading, editing, and organizing spaces, pages, comments, and members.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Docmost Local MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "wisflux-docmost-local-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wisflux/docmost-local-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @wisflux/docmost-local-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 29d ago.

Overview

wisflux/docmost-local-mcp MCP server connects local MCP clients to self-hosted Docmost through a Rust server launched by npx. It authenticates with a Docmost email and password, stores session state locally, and exposes tools for reading and modifying spaces, pages, comments, and workspace membership data. Reach for it when an AI client needs access to a Docmost Community Edition instance without relying on an enterprise license or hosted control plane. It supports Claude Desktop, Cursor, and other MCP clients that can launch local stdio servers.

Use cases

  • Search Docmost spaces for procedures and runbooks
  • Create pages from meeting notes or structured Markdown
  • Update and reorganize pages across Docmost spaces
  • Add comments to pages from an AI client
  • Inspect workspace members and the authenticated user context

Key features

  • Self-hosted Docmost connectivity
  • Local stdio MCP transport
  • Read and write page, space, and comment tools
  • Markdown page and comment support
  • Local session reuse with token expiry checks
  • OS keychain or encrypted credential storage

Tools20

What Docmost Local MCP lets your agent do. Expand a tool for its parameters.

Self-reported~284 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @wisflux/docmost-local-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars15Stargazers on the source repository.
npm downloads159Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed20Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Docmost Local MCP works

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.

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.

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Docmost Local MCP

Run `npx -y @wisflux/docmost-local-mcp`. Node.js 18 or newer is required.

Yes.

Pass `--base-url=https://docs.example.com` when starting the server or set `DOCMOST_BASE_URL`. Without either setting, the login flow asks for the instance URL.

No enterprise license is required according to the project description; it is designed for self-hosted Docmost, including the Community Edition.

Body updates through `update_page` require Docmost v0.70.0 or newer. Title updates work on older versions, while page creation persists bodies across the documented versions.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDocmost Local MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/wisflux-docmost-local-mcp?style=directory)](https://allmcps.com/mcp/wisflux-docmost-local-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/wisflux-docmost-local-mcp"><img src="https://allmcps.com/api/badge/wisflux-docmost-local-mcp?style=directory" alt="Docmost Local MCP on AllMCPs" /></a>