Docmost MCP Server

A Model Context Protocol (MCP) server for Docmost, enabling AI agents to search, create, modify, and organize documentation pages and spaces.

Features

Core Management

create_page: Smart creation tool. Creates content (via import) AND handles hierarchy (nesting under a parent) in one go.
update_page: ⚠️ IMPORTANT: This tool recreates the page with a new ID and deletes the old page. While it preserves child pages and hierarchy, all references to the old page ID will break, including:
- Comments and discussions
- Page history/changelog
This is a workaround limitation due to Docmost's API not providing a native update endpoint. Use with caution!
delete_page / delete_pages: Delete single or multiple pages at once.
move_page: Organize pages hierarchically by moving them to a new parent or root.

Exploration & Retrieval

search: Full-text search across spaces with optional space filtering (query, spaceId).
get_workspace: Get information about the current Docmost workspace.
list_spaces: View all spaces within the current workspace.
list_groups: View all groups within the current workspace.
list_pages: List pages within a space (ordered by updatedAt descending).
get_page: Retrieve full content and metadata of a specific page.

Technical Details

Automatic Markdown Conversion: Page content is automatically converted from Docmost's internal ProseMirror/TipTap JSON format to clean Markdown for easy agent consumption. Supports all Docmost extensions including callouts, task lists, math blocks, embeds, and more.
Smart Import API: Uses Docmost's import API to ensure clean Markdown-to-ProseMirror conversion when creating pages.
Child Preservation: The update_page tool creates a new page ID but effectively simulates an in-place update by reparenting existing child pages to the new version.
Pagination Support: Automatically handles pagination for large datasets (spaces, pages, groups).
Filtered Responses: API responses are filtered to include only relevant information, optimizing data transfer for agents.

Installation

npm install
npm run build

Configuration

This server requires the following environment variables to be set:

DOCMOST_API_URL: The full URL to your Docmost API (e.g., https://docs.example.com/api).
DOCMOST_EMAIL: The email address for authentication.
DOCMOST_PASSWORD: The password for authentication.

usage with Claude Desktop / generic MCP Client

Add the following to your MCP configuration (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "docmost": {
      "command": "node",
      "args": ["/path/to/docmost-mcp/build/index.js"],
      "env": {
        "DOCMOST_API_URL": "https://your-docmost-instance.com/api",
        "DOCMOST_EMAIL": "your-email@example.com",
        "DOCMOST_PASSWORD": "your-password"
      }
    }
  }
}

Development

# Watch mode
npm run watch

# Build
npm run build

License

MIT

3.1 KiB Raw Blame History