Docmost (self-hosted) MCP

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.

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…

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…

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…

Change the title of a page; its body and place in the tree stay as they are.

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.

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.

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…

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…

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.

List the pages in the Trash of a space, most recently deleted first.

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.

Restore a page from the Trash, with its child pages. Use list_trash to find it.

List the snapshots of a page body that this server saved before your own changes to it, newest first. Snapshots are kept … days.

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.

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.

Takes no parameters.

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 … minutes. To read a page, use get_page; export when the person wants a file.

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 … minutes; Docmost builds the zip when the link is opened.

List the files uploaded to a page (Docmost 0.96 or newer).

Details of a file uploaded to a page, with a download link that works for … minutes. A small text file (up to … KB) is also returned in the result.

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…

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.

Upload a file to a page, given as base64, up to … 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…

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…

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.

Read one saved version of a page from list_page_history, as Markdown converted by this server.

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.

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.

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.

List labels: those of one page, or without page all labels used in the workspace. Needs Docmost 0.90 or newer.

List the pages that carry a label, in all spaces or in one. Needs Docmost 0.90 or newer.

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.

Remove a label from a page. A label no page uses any more disappears from the workspace. Needs Docmost 0.90 or newer.

List the users and groups that have a role in a space.

List the people in the Docmost workspace with their workspace role, optionally filtered by a part of their name or email.

List the workspace's groups, optionally filtered by a part of their name.

Create a space; you become its admin. Needs a Docmost workspace admin or owner.

Change a space's name, slug or description. Changing the slug changes the space's URLs. Needs admin rights in the space.

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.

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.

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.

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.

List the people in a group.

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.

Rename a group or change its description. Needs a workspace admin or owner.

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.

List pending invitations to the workspace, optionally filtered by a part of the email.

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…

Send an invitation email again, for someone who did not get it or lost it. Needs a workspace admin or owner.

Cancel a pending invitation; its link stops working. The person can be invited again later. Needs a workspace admin or owner.

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.

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.

Let a person deactivated with deactivate_member sign in again, with their roles as before. Needs a workspace admin or owner.

List the Docmost spaces you can access, with your role in each. Start here to get the space ids other tools need.

Details of one space: name, description, visibility, number of members and your role in it.

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.

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.

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…

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.

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.

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.

List the comments on a page, oldest first. Replies carry parent_comment_id.