docmost-mcp-remote
A remote MCP server that lets an AI client read and edit a Docmost wiki as the signed-in member, with their own permissions.
Account & discovery:
whoami,list_spaces,get_space,suggest(quick name lookup),check_space_health(stale/empty/duplicate pages, broken links).Browsing & reading:
list_pages,get_page_tree,recent_pages,get_page(Markdown or ProseMirror JSON),get_page_outline,get_section.Search: full-text
searchwith snippets, filters for titles only, labels or your own pages.Writing pages:
create_page,update_page(append/prepend/replace with dry-run diff),replace_section(hash-guarded),replace_page_json,rename_page,move_page,move_page_to_space,duplicate_page.Comments:
list_comments,add_commentwith @-mentions,update_comment.History & safety:
list_page_history,get_page_version,diff_page,list_snapshots,restore_page_version,restore_snapshot— full-body rewrites are refused while someone else is editing, and a snapshot is saved before each change.Labels & links:
list_backlinks,list_labels,find_pages_by_label,add_labels,remove_label(Docmost 0.90+).Files & export:
export_page,export_space,list_attachments,get_attachment,create_upload_link(browser link, no tokens),get_upload_status,upload_attachment(base64, ≤10 MB).Trash:
list_trash,trash_page,restore_page— nothing is deleted permanently.People & groups:
list_space_members,list_workspace_members,list_groups,list_group_members,list_invitations,create_group,update_group,add_group_members.Space administration:
create_space,update_space,add_space_members,change_space_member_role.Workspace administration:
invite_people,resend_invitation,revoke_invitation,change_workspace_role,deactivate_member,activate_member.Plus resources (
docmost://spaces,docmost://pages/{page}) and prompts (summarize, answer from wiki, what's new, draft/tidy page), with read-only by default and write/delete/admin scopes opt-in per client.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@docmost-mcp-remote search the wiki for our onboarding docs and summarize the setup steps"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
docmost-mcp-remote
Let your team's AI assistants read and edit your Docmost wiki, each member as themselves.
A self-hosted remote MCP server for Docmost Community Edition.
English · Русский
Highlights · Comparison · Quick start · Connect a client · Tools · Security · Configuration · Feedback
Run it next to your Docmost, put it behind your domain, and connect Claude, Claude Code, Cursor, VS Code or any other MCP client. Every member signs in with their own Docmost account, so the assistant sees exactly what they can see and every change in Docmost carries their name.
Docker images use Python 3.15 and support amd64 and arm64. Installing the Python package directly supports Python 3.12 through 3.15.
Independent community project, not affiliated with or endorsed by Docmost, Inc. Docmost is a trademark of Docmost, Inc.; the name is used only to say which software this server works with.
✨ Highlights
👥 One server for the whole team. Each member signs in once in the browser with their own Docmost account. Everything their AI client does is done as them, with their Docmost rights.
🔐 Real authorization. OAuth 2.1 for remote connectors (Claude.ai, Claude Desktop, Claude Code, Cursor, VS Code) and personal tokens for scripts. There is no unauthenticated mode.
🛡️ Safe by default. Only
readis granted without asking;write,deleteandadminare opt-in per client. Nothing is deleted permanently, risky changes ask you first, and an encrypted snapshot of a page is saved before every change.🧰 62 tools. Read, search, write by section, comment with @-mentions, move, label, export, restore old versions, check a space's health and run the workspace: spaces, groups, invitations and roles.
📎 Files without burning tokens. The assistant gives you an upload link: drop files in the browser, put them in order, and they land in the right place of the page.
🐳 Easy to host. One container plus Postgres with a ready
compose.yaml, orpip install. Tested in CI against Docmost 0.80.1 to 0.97.
⭐ If this server is useful to you, please star the repository. It helps other Docmost users find it and tells us the work is worth continuing.
Related MCP server: MediaWiki MCP Server
🆚 How it compares
There are several open-source MCP servers for Docmost Community Edition. Most of them run on one person's machine with one shared Docmost account. This one is built to be shared by a team.
Feature | This server | Other Docmost CE MCP servers |
Remote server for many people, with OAuth 2.1 sign-in | ✅ | ❌ |
Each member acts with their own Docmost account and rights | ✅ | ❌ |
Per-client scopes, read-only by default | ✅ | ⚠️ a global read-only switch at most |
Nothing is deleted permanently | ✅ | ❌ |
Encrypted snapshot before every change, with restore | ✅ | ❌ |
Write is read back and checked | ✅ | ⚠️ rare |
Risky changes ask you first in the client (MCP elicitation) | ✅ | ⚠️ rare |
Rewrites refused while someone else is editing the page | ✅ | ⚠️ rare |
Edit one section, refused if it changed since it was read | ✅ | ⚠️ rare |
Upload files through a browser link, no tokens spent | ✅ | ❌ |
Restore a page version with all formatting | ✅ | ⚠️ rare |
Page content marked as untrusted for the model | ✅ | ⚠️ rare |
Audit log and per-member rate limits | ✅ | ❌ |
Space health check: stale, empty and duplicate pages, broken links | ✅ | ⚠️ rare |
Workspace admin: invitations, roles, groups | ✅ | ⚠️ rare |
Resources and prompts as well as tools | ✅ | ⚠️ rare |
Releases on PyPI, ghcr.io and the MCP Registry, CI on several Docmost versions | ✅ | ⚠️ rare |
Based on the public Docmost CE MCP servers we could find in October 2026. They are good choices for a single person working locally over stdio, and some offer things this server does not, such as permanent deletion.
🧭 How it works
The first time a client connects, the member signs in with their Docmost email and password and picks what the client may do. They can see and revoke every connected app and token on their account page.
🚀 Quick start
You need Docker with Compose, a Docmost reachable from the server, and a host
name with https for the server itself, for example mcp.example.com.
Download the compose file and the settings template:
mkdir docmost-mcp && cd docmost-mcp curl -fsSLO https://raw.githubusercontent.com/bbik52/docmost-mcp-remote/master/compose.yaml curl -fsSL -o .env https://raw.githubusercontent.com/bbik52/docmost-mcp-remote/master/.env.exampleEdit
.env: setPUBLIC_URL(the https URL of this server),DOCMOST_URL, a long randomPOSTGRES_PASSWORDandSECRET_KEY(openssl rand -hex 32gives a good value for both). ConsiderALLOWED_EMAILSto limit who can sign in.Start it and check that it is up:
docker compose up -d curl http://127.0.0.1:8000/healthzPut a reverse proxy with https in front of
127.0.0.1:8000(see Reverse proxy) and openPUBLIC_URL/loginin a browser to check that you can sign in with your Docmost account.Connect a client (see Connecting a client).
The server applies its database migrations at startup. Back up the Postgres
volume like you back up Docmost: it holds the encrypted sessions, the
snapshots and the audit log. Losing SECRET_KEY signs every member out and
makes the snapshots unreadable.
# docmost-mcp-remote: the server and its Postgres.
# Copy .env.example to .env and fill in the required values first, then put a
# reverse proxy with https in front of port 8000.
services:
server:
# "1" follows 1.x releases; set IMAGE_TAG to a full version such as 1.1.0 to pin one.
image: ghcr.io/bbik52/docmost-mcp-remote:${IMAGE_TAG:-1}
restart: unless-stopped
environment:
PUBLIC_URL: ${PUBLIC_URL:?set PUBLIC_URL to the public https URL of this server}
DOCMOST_URL: ${DOCMOST_URL:?set DOCMOST_URL to the base URL of your Docmost}
DOCMOST_ALLOW_INSECURE_HTTP: ${DOCMOST_ALLOW_INSECURE_HTTP:-false}
DATABASE_URL: postgresql://docmost_mcp:${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD}@postgres:5432/docmost_mcp
SECRET_KEY: ${SECRET_KEY:?set SECRET_KEY to a random value of at least 32 characters}
SECRET_KEY_PREVIOUS: ${SECRET_KEY_PREVIOUS:-}
ALLOWED_EMAILS: ${ALLOWED_EMAILS:-}
ALLOWED_SPACES: ${ALLOWED_SPACES:-}
OAUTH_REDIRECT_ALLOWLIST: ${OAUTH_REDIRECT_ALLOWLIST:-}
RELOGIN_MODE: ${RELOGIN_MODE:-ask}
SNAPSHOT_RETENTION_DAYS: ${SNAPSHOT_RETENTION_DAYS:-30}
AUDIT_RETENTION_DAYS: ${AUDIT_RETENTION_DAYS:-90}
UPLOAD_RETENTION_MINUTES: ${UPLOAD_RETENTION_MINUTES:-60}
UPLOAD_MAX_MB: ${UPLOAD_MAX_MB:-50}
TOOL_CALLS_PER_MINUTE: ${TOOL_CALLS_PER_MINUTE:-60}
MAX_PAGE_CHARS: ${MAX_PAGE_CHARS:-60000}
# Proxies on loopback or a private network; the client address is the last
# untrusted one in X-Forwarded-For, so a header sent by the client is ignored.
FORWARDED_ALLOW_IPS: ${FORWARDED_ALLOW_IPS:-127.0.0.1,::1,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16,fc00::/7}
LOG_LEVEL: ${LOG_LEVEL:-info}
ports:
- "127.0.0.1:8000:8000"
depends_on:
postgres:
condition: service_healthy
read_only: true
tmpfs:
- /tmp
cap_drop:
- ALL
security_opt:
- no-new-privileges:true
postgres:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_USER: docmost_mcp
POSTGRES_DB: docmost_mcp
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD}
volumes:
- postgres-data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U docmost_mcp -d docmost_mcp"]
interval: 10s
timeout: 5s
retries: 5
volumes:
postgres-data:The server is also on PyPI (pip install docmost-mcp-remote or
uvx docmost-mcp-remote) for setups without containers; it needs Postgres
and the same settings as environment variables.
Reverse proxy
The server listens on plain http and expects a reverse proxy that terminates https. Serve it at the root of its own host name; a sub-path is not supported. The proxy must not buffer responses, because MCP streams them.
Caddy (gets certificates by itself):
mcp.example.com {
reverse_proxy 127.0.0.1:8000
}server {
listen 443 ssl;
server_name mcp.example.com;
ssl_certificate /etc/letsencrypt/live/mcp.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/mcp.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
proxy_read_timeout 1h;
}
}The server uses X-Forwarded-For for its per-IP rate limits. The proxy must
set the header to the address it sees, not pass on what the client sent: the
nginx example above does that with $remote_addr, and Caddy and Traefik do it
by default. The compose file trusts proxies on loopback and private networks
(FORWARDED_ALLOW_IPS); if your proxy reaches the server from a public
address, set it to that address.
🔌 Connecting a client
The MCP endpoint is PUBLIC_URL/mcp, for example
https://mcp.example.com/mcp. Clients that support MCP authorization open a
browser window: sign in with your Docmost email and password and choose what
the client may do. read is always granted; tick write, delete or
admin only for clients you trust.
Give clients the full endpoint, ending in /mcp. The server's base URL alone
is refused with invalid_target. After "Allow" a page sends you back to the
app; if the browser asks whether to open a desktop app such as Cursor, allow
it, or use the link on the page.
Settings, Connectors, Add custom connector, then enter the endpoint URL. The server must be reachable from the internet over https for Claude.ai.
claude mcp add --transport http docmost https://mcp.example.com/mcpThen run /mcp in Claude Code to sign in.
~/.cursor/mcp.json:
{
"mcpServers": {
"docmost": { "url": "https://mcp.example.com/mcp" }
}
}.vscode/mcp.json:
{
"servers": {
"docmost": { "type": "http", "url": "https://mcp.example.com/mcp" }
}
}Open
PUBLIC_URL/loginand sign in with your Docmost email and password.On the account page, create a personal token with the scopes you need. It expires after 90 days unless you pick another lifetime (7 days to a year, or never).
Configure the client with the endpoint and the header
Authorization: Bearer <token>:claude mcp add --transport http docmost https://mcp.example.com/mcp \ --header "Authorization: Bearer dmr_..."
Connected apps and tokens are listed and revoked on the account page,
PUBLIC_URL/account.
Operators can optionally restrict OAuth callbacks with OAUTH_REDIRECT_ALLOWLIST.
It stays empty by default. See the callback guide for
seven common clients, exact addresses, a multi-client example and setup steps.
🧰 Tools
62 tools in groups. The scope is what a client needs to be granted to see the
tool: read is always granted, the others are opt-in.
Account and spaces
# | Tool | Scope | What it does |
1 |
| read | The Docmost account, scopes and Docmost version of this connection, and the link to the account page |
2 |
| read | Spaces you can access, with your role |
3 |
| read | One space: description, visibility, member count, your role |
4 |
| read | Stale, empty and untitled pages, duplicate titles, broken links and top editors of a space |
Browsing and reading pages
# | Tool | Scope | What it does |
5 |
| read | Page tree of a space, one level at a time |
6 |
| read | Several levels of the page tree in one call, within depth and size limits |
7 |
| read | Recently updated pages |
8 |
| read | One page as Markdown, or as ProseMirror JSON with all formatting, by id, slug id or Docmost URL |
9 |
| read | The headings of a page, to find a section without reading the whole body |
10 |
| read | One section of a page, with a hash for |
Search
# | Tool | Scope | What it does |
11 |
| read | Quick lookup of pages, people and groups by name |
12 |
| read | Full-text search with snippets; filters by title only, labels or your own pages |
Writing pages
# | Tool | Scope | What it does |
13 |
| write | New page with a Markdown body, optionally under a parent |
14 |
| write | Append, prepend or replace a page body with Markdown; |
15 |
| write | Replace one section of a page, refused if it changed since it was read |
16 |
| write | Replace a page body with ProseMirror JSON, checked against the editor schema first; |
17 |
| write | Change a page title |
18 |
| write | Move a page within its space, to the start, the end or after a sibling |
19 |
| write | Move a page with its children to another space |
20 |
| write | Copy a page with its children, in the same space or into another one |
Comments
# | Tool | Scope | What it does |
21 |
| read | Comments and replies on a page |
22 |
| write | Comment on a page or reply to a comment, optionally @-mentioning people, whom Docmost notifies |
23 |
| write | Change the text of one of your own comments |
History, snapshots and restore
# | Tool | Scope | What it does |
24 |
| read | Versions of a page saved by Docmost, with who changed it |
25 |
| read | One saved version of a page as Markdown |
26 |
| read | Snapshots this server saved before your changes to a page |
27 |
| read | Unified diff between the current body, a saved version or a snapshot |
28 |
| write | Put a page body back to a version from its history, formatting included |
29 |
| write | Put a page body back to a snapshot |
Labels and links
# | Tool | Scope | What it does |
30 |
| read | Pages that link to a page, or that a page links to (Docmost 0.90+) |
31 |
| read | Labels of the workspace or of one page (Docmost 0.90+) |
32 |
| read | Pages with a label in a space (Docmost 0.90+) |
33 |
| write | Add labels to a page (Docmost 0.90+) |
34 |
| write | Remove a label from a page (Docmost 0.90+) |
Files and export
# | Tool | Scope | What it does |
35 |
| read | A page as Markdown or HTML; with children or files, a download link to a zip |
36 |
| read | A download link to a zip of a whole space (space admins) |
37 |
| read | Files uploaded to a page (Docmost 0.96+) |
38 |
| read | Details of a file with a download link; small text files inline |
39 |
| write | A link where the person drops files into a page in the browser, or the assistant sends them with |
40 |
| read | Files sent to an upload link and whether they are in the page yet |
41 |
| write | Upload a file as base64 (up to 10 MB, about a million tokens per MB) and add it to the page |
Trash
# | Tool | Scope | What it does |
42 |
| read | Pages in the Trash of a space |
43 |
| delete | Move a page to the Trash |
44 |
| delete | Restore a page from the Trash |
People and groups
# | Tool | Scope | What it does |
45 |
| read | Users and groups with a role in a space |
46 |
| read | People in the workspace, with their role |
47 |
| read | Groups of the workspace |
48 |
| read | People in a group |
49 |
| read | Pending invitations to the workspace |
Space administration
# | Tool | Scope | What it does |
50 |
| admin | Create a space |
51 |
| admin | Change a space's name, slug or description |
52 |
| admin | Give users (by email) and groups (by name) a role in a space |
53 |
| admin | Change the role of a user or group in a space |
Workspace administration
# | Tool | Scope | What it does |
54 |
| admin | Create a group, optionally with members |
55 |
| admin | Rename a group or change its description |
56 |
| admin | Add people to a group |
57 |
| admin | Invite people by email, with a workspace role and groups; existing members and pending invitations are skipped |
58 |
| admin | Send an invitation again |
59 |
| admin | Cancel an invitation |
60 |
| admin | Make someone a member, admin or owner of the workspace |
61 |
| admin | Stop someone from signing in, keeping their account |
62 |
| admin | Let a deactivated member sign in again |
People cannot be removed from the workspace or from groups, and groups cannot be deleted. Docmost has no way to create an account or edit someone else's profile: people join through an invitation and set their own password.
🛡️ Safety nets
Snapshots. Before every body change the server saves the current body as a snapshot in its own database, encrypted, for
SNAPSHOT_RETENTION_DAYS; if the snapshot cannot be saved, nothing is written. Snapshots can hold content of pages that were later deleted in Docmost until they expire.Read-back. After a change the server reads the page back and reports an error if Docmost did not apply it (this happens when Docmost runs with
COLLAB_DISABLE_REDIS).Confirmation. Risky changes ask you first, in your client, where the client supports it (MCP elicitation): moving a page to the Trash, moving or copying a page to another space, giving people or groups a role in a space, inviting people, changing a workspace role and deactivating someone. The question goes to you, not to the model, so text in a page cannot answer it. If the client says it can ask but the question fails, nothing changes. Clients that cannot ask make these changes without the question, within the scopes you granted.
Busy pages. A change that rewrites the whole body (a replace, a section, a JSON write, a restore) is refused while someone else is editing the page, that is when another person saved it in the last minute, because their typing would be lost. Appending and prepending merge with their edits and are not refused.
Untrusted content. Page bodies, comments and snippets are returned inside a
<docmost-untrusted-content>envelope so the model treats them as data.
📎 Adding files
Passing a file to the model costs tokens: as base64, about a million per
megabyte. So create_upload_link gives a one-time link to a page instead.
The person opens it, drops in one or more files (or picks them), puts them in
order and presses Done; the files appear in the page at the end, at the end
of a section (after_heading) or after a paragraph (after_text). An
assistant that can run commands sends files it has with curl to the same
link. Until Done the files are kept on this server, encrypted; the link works
for UPLOAD_RETENTION_MINUTES and whatever was not added by then is deleted.
upload_attachment takes the same place parameters.
💬 Resources and prompts
Besides tools, which the model picks itself, the server offers resources and prompts that you pick in your client, where the client supports them (Claude Desktop and Claude Code do; many clients only support tools).
Resource | What it holds |
| The spaces you can access, with your role |
| One page as Markdown, with its place and link. While you type a title, the client is offered matching pages |
Prompt | Scope | What it asks for |
| read | A summary of a page: purpose, key points, what looks outdated |
| read | An overview of a space: what it covers, how it is organised, its gaps |
| read | An answer only from wiki pages, with links to them |
| read | What changed in the wiki or in a space in the last days, page by page |
| write | A draft page on a topic, after checking for existing ones; created once you agree |
| write | Better structure and wording of a page without changing its facts; written once you agree |
A prompt only writes the request; the model does the work with the tools the
connection is allowed to use. Resource reads count against
TOOL_CALLS_PER_MINUTE and go to the audit log as read_resource.
📦 Supported Docmost versions
Docmost Community Edition 0.80.1 or newer. Older versions are refused at
sign-in and on every tool call: they have published security advisories that
the endpoints this server calls expose (CVE-2026-34212, fixed in 0.71.0, and
CVE-2026-48073, fixed in 0.80.1). CI runs the integration tests against
Docmost 0.80.1, 0.96.0 and 0.97.0; newer releases work in most cases and log a warning until they are
added to the tested range. Docmost users who sign in with SSO only (an
Enterprise feature) cannot use this server: it signs in with email and
password. Labels and backlinks need Docmost 0.90 or newer, and the
title_only and labels search filters and list_attachments need 0.96 or
newer; on older versions these tools answer that Docmost needs an upgrade.
🔐 Security model
Members sign in with their own Docmost account; everything a client does is
done as that member, with their Docmost rights. The server keeps the Docmost
session token encrypted with a key derived from SECRET_KEY and does not
store passwords unless RELOGIN_MODE=stored_password. Personal tokens are
stored as hashes, shown once and expire after 90 days by default. The
sign-in page has CSRF protection and per-IP and per-email rate limits, and
"Sign out everywhere" on the account page ends its sessions in every
browser.
The server is its own OAuth 2.1 authorization server, following the MCP
authorization spec: dynamic client registration (limited per IP, redirect
URIs must be https, loopback http or a native app scheme), authorization
code with PKCE (S256 only), exact redirect URI match, tokens bound to this
server's /mcp resource, one-hour access tokens and 30-day refresh tokens
that rotate on every use. A reused refresh token or a replayed code revokes
the whole grant. OAuth grants and personal tokens are listed and revoked on
the same account page.
Page content is treated as untrusted data and labelled as such for the model;
titles and names, which are returned as plain fields, lose hidden and control
characters and are cut at 300 characters.
Prompt injection in a page can still make a client act within the scopes the
member granted, so grant write, delete and admin only to clients you trust.
Tool calls and resource reads are limited per member and recorded in an
audit log.
Exports of several pages and file downloads are handed out as links to this server that are valid for ten minutes. A link carries, encrypted, who asked and what to download, so anyone holding it can download the file until it expires; the server streams the file from Docmost with that member's session and stores nothing. Links are kept out of the access log.
See the threat model, SECURITY.md for how to report a vulnerability and the design.
🛠️ Administration
The admin command runs where the server runs, with the same environment:
docker compose exec server docmost-mcp-remote admin members
docker compose exec server docmost-mcp-remote admin migrate
docker compose exec server docmost-mcp-remote admin grants anna@example.com
docker compose exec server docmost-mcp-remote admin revoke-grant <grant id>
docker compose exec server docmost-mcp-remote admin revoke-member anna@example.com
docker compose exec server docmost-mcp-remote admin disable-member anna@example.com
docker compose exec server docmost-mcp-remote admin audit --email anna@example.comrevoke-member revokes every grant of the member and drops their stored
Docmost session; disable-member blocks them until enable-member. Every
tool call and resource read is recorded in the audit log with the tool, the page or space id
and the outcome, never with content or arguments.
To rotate SECRET_KEY: set the old value as SECRET_KEY_PREVIOUS and a new
SECRET_KEY, restart, run admin rotate-key, then remove
SECRET_KEY_PREVIOUS and restart again.
⬆️ Upgrading
Read the changelog for "Upgrade notes".
Back up the database:
docker compose exec -T postgres pg_dump -U docmost_mcp -Fc docmost_mcp > docmost-mcp-$(date +%F).dumpPull the new image and restart:
docker compose pull && docker compose up -d
The server upgrades its database schema at startup, in one transaction and
one process at a time, so a failed upgrade leaves the old schema in place.
docker compose exec server docmost-mcp-remote admin migrate shows the
schema revision.
The image tag 1 follows 1.x releases; set IMAGE_TAG in .env to pin a
version. Going back to an older version after its schema was upgraded is not
supported: an older server refuses to start on a newer schema. To roll back,
restore the backup with the old image:
docker compose stop server
docker compose exec -T postgres pg_restore -U docmost_mcp -d docmost_mcp --clean --if-exists < docmost-mcp-2026-01-31.dump
IMAGE_TAG=1.1.0 docker compose up -d⚙️ Configuration
Variable | Required | Default | Meaning |
| yes | Public https URL of this server | |
| yes | Base URL of your Docmost | |
| no |
| Allow an |
| yes | Postgres URL ( | |
| yes | At least 32 characters; encrypts stored Docmost sessions and signs cookies | |
| no | The old key during a rotation | |
| no | empty | Comma-separated emails allowed to sign in; empty allows every Docmost user |
| no | empty | Comma-separated space slugs or ids members may use through this server; empty allows all |
| no | empty | Optional comma-separated exact OAuth callback URIs; empty keeps supported redirects open. Loopback http callbacks stay allowed on any port. See the callback guide for seven common clients. |
| no |
| Longest page body returned; longer bodies are truncated |
| no |
| Days a snapshot of a page body is kept |
| no |
| Days an audit log entry is kept |
| no |
| Minutes an upload link works; files not added to the page by then are deleted |
| no |
| Largest total size of the files sent to one upload link |
| no |
| Tool calls and resource reads one member may make per minute, over all their clients |
| no |
| Hours a sign-in to the account page lasts |
| no |
|
|
| no |
| Timeout for one request to Docmost |
| no |
| Largest Docmost response the server reads |
| no |
| Proxies trusted for |
| no |
| Listen address |
| no |
|
|
| no |
| Image tag used by |
🧑💻 Development
uv sync
uv run ruff check . && uv run ruff format --check .
uv run mypy
DATABASE_TEST_URL=postgresql://test:test@localhost:5433/test uv run pytestTests that need Postgres are skipped without DATABASE_TEST_URL; for example
docker run -d -p 5433:5432 -e POSTGRES_USER=test -e POSTGRES_PASSWORD=test postgres:17-alpine.
Integration tests run against a real Docmost:
DOCMOST_VERSION=0.97.0 docker compose -f tests/integration/compose.yaml up -d
DOCMOST_TEST_URL=http://localhost:3000 uv run pytest tests/integrationTo run the compose stack with a local build:
docker build -t ghcr.io/bbik52/docmost-mcp-remote:dev .
IMAGE_TAG=dev docker compose up -ddocmost-mcp-remote --tool-catalog serves the tools, resources and prompts
over stdio without Docmost, a database or any configuration, and refuses
every call. MCP directories use it to list what the server offers, for
example docker run -i --rm ghcr.io/bbik52/docmost-mcp-remote --tool-catalog.
See CONTRIBUTING.md and the roadmap.
🙌 Feedback and support
⭐ Like it? Star the repository. Stars help other Docmost teams find the server and keep the project going.
Issues are not only for bugs. Ask for a new tool or feature, tell us what is awkward in your workflow, or ask a question: every request is read. For a security problem, follow SECURITY.md instead of opening an issue.
📄 License
Apache License 2.0. The license does not cover the project name: forks are welcome under another name. This project is an independent implementation and is not affiliated with Docmost. It was inspired by docmost-mcp-oss.
Available Tools
62 toolsactivate_memberActivate MemberA
Let a person deactivated with deactivate_member sign in again, with their roles as before. Needs a workspace admin or owner.
Inputs: user (required). Returns: object
add_commentAdd CommentA
Add a comment to a page as plain text, or a reply to a comment with reply_to_comment_id. Comments are visible to everyone who can see the page. People in mention (emails, names or user ids) are @-mentioned at the start of the comment, and Docmost notifies them; mention someone only when they need to act on it.
Inputs: page (required), text (required), mention, reply_to_comment_id. Returns: object
add_group_membersAdd Group MembersA
Add people (emails or user ids) to a group. They get the group's roles in spaces at once. Needs a workspace admin or owner.
Inputs: group (required), users (required). Returns: object
add_labelsAdd LabelsA
Add labels to a page; labels that do not exist yet are created. The page body is not changed. Needs Docmost 0.90 or newer.
Inputs: page (required), labels (required). Returns: object
add_space_membersAdd Space MembersA
Give users and groups a role in a space. Users are given by email or id, groups by name or id. People who already have a role keep it; use change_space_member_role for them. Needs admin rights in the space.
Inputs: role (required), space_id (required), users, groups. Returns: object
change_space_member_roleChange Space Member RoleA
Change the role of one user (email or id) or one group (name or id) in a space. Docmost keeps at least one admin per space. Needs admin rights in the space.
Inputs: role (required), space_id (required), user, group. Returns: object
change_workspace_roleChange Workspace RoleADestructive
Change a person's workspace role: member, admin or owner. Admins manage people and spaces; owners also manage the workspace and other owners. Only an owner can make or change owners, and Docmost keeps at least one owner. Needs a workspace admin or owner.
Inputs: role (required), user (required). Returns: object
check_space_healthCheck Space HealthARead-only
A health check of one space: pages not updated for stale_days, empty and untitled pages, pages sharing a title, links and @-mentions to pages that are gone or in Trash, and who updated most pages. It reads every page, up to max_pages, so it takes a while on large spaces. Lists hold at most 50 entries; the summary counts all.
Inputs: space_id (required), max_pages, stale_days. Returns: object
create_groupCreate GroupA
Create a group, optionally with its first members (emails or user ids). Groups can then be given a role in spaces with add_space_members. Needs a Docmost workspace admin or owner.
Inputs: name (required), users, description. Returns: object
create_pageCreate PageA
Create a page in a space, optionally under a parent page and with a Markdown body. Returns the new page's id and link. Each call creates a new page, so do not repeat it to retry; to change an existing page use update_page.
Inputs: title (required), space_id (required), content, parent_page_id. Returns: object
create_spaceCreate SpaceA
Create a space; you become its admin. Needs a Docmost workspace admin or owner.
Inputs: name (required), slug (required), description. Returns: object
create_upload_linkCreate Upload LinkA
Make a link for adding files to a page, and the best way to upload: it costs no tokens. Give the link to the person: they open it in a browser, drop in one or more files, put them in order and press Done, and the files appear in the page. If you can run commands with network access, send files you have yourself with the curl command in the result instead of upload_attachment. The link works for 60 minutes and takes files of up to 50 MB in total; files not added by then are deleted. Anyone with the link can add files to the page until then. Check the outcome with get_upload_status.
Inputs: page (required), after_text, after_heading. Returns: object
deactivate_memberDeactivate MemberADestructive
Deactivate a person: they are signed out everywhere and cannot sign in, but their account, pages and roles stay, and activate_member lets them back in. Use it when someone leaves. You cannot deactivate yourself. Needs a workspace admin or owner.
Inputs: user (required). Returns: object
diff_pageDiff PageARead-only
Show what changed in a page between two points as a unified diff: 'current', a version from list_page_history, or a snapshot from list_snapshots. By default from_version is compared with the current body.
Inputs: page (required), from_version (required), to_version. Returns: object
duplicate_pageDuplicate PageA
Copy a page with its child pages, attachments and labels. Without target_space_id the copy lands next to the original and is titled 'Copy of ...'; with it, the copy goes to the top level of that space under the same title, and clients that can ask the person first do so. Comments and history are not copied.
Inputs: page (required), target_space_id. Returns: object
export_pageExport PageARead-only
Export a page as Docmost does, as Markdown or HTML. A single page is returned in the result; with its child pages or its files, or when it is too long, the result is a download link to a zip that works for 10 minutes. To read a page, use get_page; export when the person wants a file.
Inputs: page (required), format, include_children, include_attachments. Returns: object
export_spaceExport SpaceARead-only
Export a whole space as a zip of Markdown or HTML files, optionally with its files. Needs admin rights in the space. The result is a download link that works for 10 minutes; Docmost builds the zip when the link is opened.
Inputs: space_id (required), format, include_attachments. Returns: object
find_pages_by_labelFind Pages By LabelARead-only
List the pages that carry a label, in all spaces or in one. Needs Docmost 0.90 or newer.
Inputs: label (required), limit, cursor, space_id. Returns: object
get_attachmentGet AttachmentARead-only
Details of a file uploaded to a page, with a download link that works for 10 minutes. A small text file (up to 256 KB) is also returned in the result.
Inputs: attachment_id (required). Returns: object
get_pageGet PageARead-only
Read one page: its title, location and body as Markdown. Accepts a page id, the short slug id, or a Docmost page URL. Very long bodies are truncated; truncated tells when that happened. format='json' returns the body as Docmost's ProseMirror JSON instead, with all formatting, for replace_page_json; it is never truncated, so a page too large for it is refused.
Inputs: page (required), format. Returns: object
get_page_outlineGet Page OutlineARead-only
The headings of a page with their level and size, without the body. Use it to find a section of a long page, then get_section to read it and replace_section to change it. Section 0 is the text before the first heading.
Inputs: page (required). Returns: object
get_page_treeGet Page TreeARead-only
The page tree of a space, or of one page, several levels deep in one call. The walk stops at max_depth levels or max_pages pages; pages whose children were not read are listed in not_expanded, and get_page_tree with that page as root_page_id continues there.
Inputs: space_id (required), max_depth, max_pages, root_page_id. Returns: object
get_page_versionGet Page VersionARead-only
Read one saved version of a page from list_page_history, as Markdown converted by this server.
Inputs: version_id (required). Returns: object
get_sectionGet SectionARead-only
Read one section of a page as Markdown: its heading and everything up to the next heading of the same or a higher level, subsections included. Returns section_hash for replace_section.
Inputs: page (required), index (required). Returns: object
get_spaceGet SpaceARead-only
Details of one space: name, description, visibility, number of members and your role in it.
Inputs: space_id (required). Returns: object
get_upload_statusGet Upload StatusARead-only
What happened to an upload link: the files sent to it so far and, once Done was pressed, whether they were added to the page.
Inputs: upload_id (required). Returns: object
invite_peopleInvite PeopleA
Invite people to the workspace by email. Docmost emails each one a link to join and set a password; they get the workspace role (member or admin) and join the groups given (names or ids). Emails of people already in the workspace or already invited are skipped and listed. Check the addresses with the person you work for before inviting. Needs a workspace admin or owner.
Inputs: emails (required), role, groups. Returns: object
list_attachmentsList AttachmentsARead-only
List the files uploaded to a page (Docmost 0.96 or newer).
Inputs: page (required), limit, cursor. Returns: object
list_backlinksList BacklinksARead-only
Pages that link to this page (incoming), or that this page links to (outgoing). Use it before moving, renaming or trashing a page. Needs Docmost 0.90 or newer.
Inputs: page (required), limit, cursor, direction. Returns: object
list_commentsList CommentsARead-only
List the comments on a page, oldest first. Replies carry parent_comment_id.
Inputs: page_id (required), limit, cursor. Returns: object
list_group_membersList Group MembersCRead-only
List the people in a group.
Inputs: group (required), limit, cursor. Returns: object
list_groupsList GroupsARead-only
List the workspace's groups, optionally filtered by a part of their name.
Inputs: limit, query, cursor. Returns: object
list_invitationsList InvitationsARead-only
List pending invitations to the workspace, optionally filtered by a part of the email.
Inputs: limit, query, cursor. Returns: object
list_labelsList LabelsARead-only
List labels: those of one page, or without page all labels used in the workspace. Needs Docmost 0.90 or newer.
Inputs: page, limit, cursor. Returns: object
list_page_historyList Page HistoryARead-only
List the versions of a page that Docmost saved, newest first, with who changed it. Docmost saves a version a few minutes after edits stop. Read one with get_page_version or compare with diff_page.
Inputs: page (required), limit, cursor. Returns: object
list_pagesList PagesARead-only
List pages of a space as a tree, one level at a time: without parent_page_id the top-level pages, with it the children of that page. has_children tells whether a page has children to list next. To see several levels in one call, use get_page_tree; to find a page by name, use suggest or search.
Inputs: space_id (required), limit, cursor, parent_page_id. Returns: object
list_snapshotsList SnapshotsARead-only
List the snapshots of a page body that this server saved before your own changes to it, newest first. Snapshots are kept 30 days.
Inputs: page (required), limit. Returns: object
list_space_membersList Space MembersARead-only
List the users and groups that have a role in a space.
Inputs: space_id (required), limit, cursor. Returns: object
list_spacesList SpacesARead-only
List the Docmost spaces you can access, with your role in each. Start here to get the space ids other tools need.
Inputs: limit, cursor. Returns: object
list_trashList TrashARead-only
List the pages in the Trash of a space, most recently deleted first.
Inputs: space_id (required), limit, cursor. Returns: object
list_workspace_membersList Workspace MembersARead-only
List the people in the Docmost workspace with their workspace role, optionally filtered by a part of their name or email.
Inputs: limit, query, cursor. Returns: object
move_pageMove PageA
Move a page to another place in the same space: under parent_page_id, or to the top level when it is empty. The page goes to the end of that level, to the start with first=true, or right after after_page_id. Child pages move with it.
Inputs: page (required), first, after_page_id, parent_page_id. Returns: object
move_page_to_spaceMove Page To SpaceA
Move a page with its child pages to the top level of another space. Everyone in the target space gains access to them and members of the old space may lose it. Child pages you cannot access stay behind as top-level pages of the old space. Clients that can ask the person first do so.
Inputs: page (required), space_id (required). Returns: object
recent_pagesRecent PagesARead-only
List recently updated pages, newest first, in one space or in all spaces, to see what changed lately. For the changes of one page, use list_page_history.
Inputs: limit, cursor, space_id. Returns: object
remove_labelRemove LabelA
Remove a label from a page. A label no page uses any more disappears from the workspace. Needs Docmost 0.90 or newer.
Inputs: page (required), label (required). Returns: object
rename_pageRename PageA
Change the title of a page; its body and place in the tree stay as they are.
Inputs: page (required), title (required). Returns: object
replace_page_jsonReplace Page JsonADestructive
Replace a whole page body with a ProseMirror JSON document, as get_page with format='json' returns it. Unlike Markdown this keeps everything Docmost can show: colors, merged table cells, columns, diagrams, mentions, comment highlights. Read the page as JSON first, change it and send the complete document. It is checked against Docmost's editor schema before anything is written, refused while someone else is editing the page, and the previous body is saved as a snapshot. With dry_run=true nothing is written; the result lists any problems and shows the change as a Markdown diff.
Inputs: page (required), document (required), dry_run. Returns: object
replace_sectionReplace SectionADestructive
Replace one section of a page, found with get_page_outline and read with get_section. Pass the section_hash from get_section: if the section changed since, nothing is written. By default the heading is kept and content replaces what is under it, subsections included; with keep_heading=false content replaces the heading too, and an empty content removes the section. The whole body is saved as a snapshot first. The whole body is rewritten from Markdown, so this is refused on pages with formatting Markdown cannot hold, as update_page replace is.
Inputs: page (required), index (required), content (required), section_hash (required), +3 more. Returns: object
resend_invitationResend InvitationA
Send an invitation email again, for someone who did not get it or lost it. Needs a workspace admin or owner.
Inputs: invitation_id (required). Returns: object
restore_pageRestore PageA
Restore a page from the Trash, with its child pages. Use list_trash to find it.
Inputs: page (required). Returns: object
restore_page_versionRestore Page VersionADestructive
Put a page body back to a version from list_page_history, exactly as Docmost saved it, formatting included. The current body is saved as a snapshot first, so restore_snapshot can undo it. The title is not changed.
Inputs: version_id (required). Returns: object
restore_snapshotRestore SnapshotADestructive
Put a page body back to a snapshot from list_snapshots. The current body is saved as a new snapshot first, so a restore can be undone the same way.
Inputs: snapshot_id (required). Returns: object
revoke_invitationRevoke InvitationA
Cancel a pending invitation; its link stops working. The person can be invited again later. Needs a workspace admin or owner.
Inputs: invitation_id (required). Returns: object
searchSearchARead-only
Full-text search over page titles and bodies you can access. Returns matching pages with a short snippet; use get_page to read one. Can be narrowed to titles, labels or pages you created. To find a page or person by a part of its name, suggest is faster.
Inputs: query (required), limit, labels, space_id, +2 more. Returns: object
suggestSuggestARead-only
Quick lookup by name, as Docmost's own search box and @-mentions do: pages whose title matches, and optionally people and groups. Faster than search and good for finding a page id or a person's id from a part of a name.
Inputs: query (required), limit, pages, groups, +2 more. Returns: object
trash_pageTrash PageADestructive
Move a page and its child pages to the Trash of its space. It can be restored with restore_page. This server never deletes pages permanently. Clients that can ask the person first do so.
Inputs: page (required). Returns: object
update_commentUpdate CommentADestructive
Replace the text of one of your own comments with plain text. Docmost only lets you edit comments you wrote. The previous text is returned.
Inputs: text (required), comment_id (required). Returns: object
update_groupUpdate GroupA
Rename a group or change its description. Needs a workspace admin or owner.
Inputs: group (required), name, description. Returns: object
update_pageUpdate PageADestructive
Change a page body with Markdown. Prefer operation 'append' or 'prepend', which keep the existing text, comments and formatting. 'replace' rewrites the whole body; read the page first and send the complete new body. It is refused on pages with formatting Markdown cannot hold (get_page lists it in markdown_loses); use replace_page_json there. 'replace' is also refused while someone else is editing the page. The previous body is saved as a snapshot that restore_snapshot can bring back. With dry_run=true nothing is written and the result shows the change as a diff. To change one part of a long page, prefer replace_section.
Inputs: page (required), content (required), dry_run, operation, +1 more. Returns: object
update_spaceUpdate SpaceA
Change a space's name, slug or description. Changing the slug changes the space's URLs. Needs admin rights in the space.
Inputs: space_id (required), name, slug, description. Returns: object
upload_attachmentUpload AttachmentA
Upload a file to a page, given as base64, up to 10 MB. Base64 costs about a million tokens per megabyte, so prefer create_upload_link: tell the person that a link is much cheaper, and use this only for small files or when they choose it. By default the file is also added to the page, at the end or where after_heading or after_text say: images are shown, other files appear as a download block. Adding it saves a snapshot of the body first.
Inputs: page (required), file_name (required), content_base64 (required), mime_type, +3 more. Returns: object
whoamiWhoamiARead-only
Show which Docmost account this connection acts as, the scopes the member granted to this client, the Docmost version, and the account page where the member sees and revokes connected apps and tokens. Use it when unsure whose rights you act with or why a tool is missing.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 62 tools
Most tools target clearly distinct Docmost resources and actions: pages vs sections vs spaces vs groups vs invitations vs attachments. There is some overlap among page-editing tools (update_page, replace_page_json, replace_section) and restore/history tools (restore_page, restore_page_version, restore_snapshot), but the descriptions make the boundaries mostly clear.
The set overwhelmingly uses snake_case names, usually in verb_noun form such as create_page, list_comments, and restore_snapshot. A few names break the pattern (search, suggest, whoami, recent_pages), but the convention remains readable and mostly predictable.
At 62 tools, this is far beyond a well-scoped MCP tool surface and creates a heavy selection burden for an agent. Although the server covers a broad Docmost workspace, the count is excessive enough to be an extreme mismatch for practical tool use.
The surface covers core page lifecycle, spaces, comments, labels, membership, groups, invitations, history, snapshots, and attachments in depth. Some secondary operations are missing, such as deleting comments or attachments, removing space/group members, and deleting groups/spaces, but these are mostly workaroundable or intentionally omitted.
Maintenance
Related MCP Connectors
Shared project wiki for AI agents: read and write pages, next actions, and activity logs over MCP.
Hosted markdown project wikis your team's AI assistants read, search, and update over MCP.
OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
Governed memory and workspace for any AI: tasks, calendar, mail and pages, with per-action consent.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to turn conversations into a searchable personal wiki, read and organize pages, and propose edits such as merges, translations, and fact-checks as reviewable changesets.3MIT
- AlicenseNot gradedqualityAmaintenanceEnables LLM clients to read, search, create, edit, move, and delete pages and files across any MediaWiki wiki, including extension data from Wikibase, Semantic MediaWiki, Cargo, Bucket, and NeoWiki. Supports multiple wikis with per-wiki resources and OAuth-backed permissions.8 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables LLM clients to read, search, create, edit, manage, and upload content across any MediaWiki wiki, including extension-backed querying and OAuth-authenticated writes.8 npmMIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to search, read, create, edit, and archive documents, manage collections, add and view threaded comments, find backlinks, and access content through direct resource URIs with automatic rate limiting.-