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: Update a page's content and/or title. Updates are performed via real-time collaboration (WebSocket).
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-local": {
      "command": "node",
      "args": ["./build/index.js"],
      "env": {
        "DOCMOST_API_URL": "http://localhost:3000/api",
        "DOCMOST_EMAIL": "test@docmost.com",
        "DOCMOST_PASSWORD": "test"
      }
    }
  }
}

Development

# Watch mode
npm run watch

# Build
npm run build

License

MIT

2.8 KiB Raw Blame History