README.md
MCP server for Docmost - an open-source collaborative documentation platform.
MCP Docmost Server
Model Context Protocol (MCP) server for Docmost - an open-source collaborative documentation platform.
Features
- Pages: Get, search, list, create, update, delete pages
- Spaces: List, get, create spaces
- Comments: List and add comments on pages
- Users: Get current user, list workspace members
- History: View page revision history
- Export: Export pages to markdown, HTML, or PDF
Installation
Using uvx (Recommended)
uvx mcp-docmost
Using pip
pip install mcp-docmost
Configuration
Getting Auth Token
- Login to Docmost in your browser
- Open Developer Tools (F12) → Application → Cookies
- Copy the
authTokencookie value
Add to Kiro MCP Config
Add to .kiro/settings/mcp.json:
{
"mcpServers": {
"docmost": {
"command": "uvx",
"args": ["mcp-docmost"],
"env": {
"DOCMOST_URL": "https://your-docmost-instance.com",
"DOCMOST_AUTH_TOKEN": "your-auth-token-here"
}
}
}
}
Available Tools
Page Operations
| Tool | Description |
|---|---|
docmost_get_page |
Get page info and content by ID or slug |
docmost_search_pages |
Search pages by query text |
docmost_list_pages |
List pages in a space or under parent |
docmost_create_page |
Create a new page |
docmost_update_page |
Update page title or content |
docmost_delete_page |
Delete a page |
Space Operations
| Tool | Description |
|---|---|
docmost_list_spaces |
List all spaces in workspace |
docmost_get_space |
Get space info by ID or slug |
docmost_create_space |
Create a new space |
Comment Operations
| Tool | Description |
|---|---|
docmost_list_comments |
List comments on a page |
docmost_add_comment |
Add a comment to a page |
User Operations
| Tool | Description |
|---|---|
docmost_get_current_user |
Get current authenticated user |
docmost_list_members |
List workspace members |
History & Export
| Tool | Description |
|---|---|
docmost_get_page_history |
Get page revision history |
docmost_export_page |
Export page (markdown/html/pdf) |
Example Usage
User: Search for pages about "AI gợi ý"
Assistant: [calls docmost_search_pages with query="AI gợi ý"]
User: Get the content of page yQQmTbt8it
Assistant: [calls docmost_get_page with page_id="yQQmTbt8it"]
User: List all spaces
Assistant: [calls docmost_list_spaces]
Development
# Install dependencies
cd mcp-docmost
uv sync
# Run server directly
uv run python -m mcp_docmost.server
License
MIT
Tools (15)
docmost_get_pageGet page info and content by ID or slugdocmost_search_pagesSearch pages by query textdocmost_list_pagesList pages in a space or under parentdocmost_create_pageCreate a new pagedocmost_update_pageUpdate page title or contentdocmost_delete_pageDelete a pagedocmost_list_spacesList all spaces in workspacedocmost_get_spaceGet space info by ID or slugdocmost_create_spaceCreate a new spacedocmost_list_commentsList comments on a pagedocmost_add_commentAdd a comment to a pagedocmost_get_current_userGet current authenticated userdocmost_list_membersList workspace membersdocmost_get_page_historyGet page revision historydocmost_export_pageExport page (markdown/html/pdf)Environment Variables
DOCMOST_URLrequiredThe URL of your Docmost instanceDOCMOST_AUTH_TOKENrequiredAuthentication token from browser cookiesConfiguration
claude_desktop_config.json
{
"mcpServers": {
"docmost": {
"command": "uvx",
"args": ["mcp-docmost"],
"env": {
"DOCMOST_URL": "https://your-docmost-instance.com",
"DOCMOST_AUTH_TOKEN": "your-auth-token-here"
}
}
}
}Try it
→Search for pages about 'AI gợi ý' in Docmost
→Get the content of the page with ID yQQmTbt8it
→List all available spaces in my Docmost workspace
→Export the 'Project Roadmap' page to PDF format
→Add a comment to the 'Onboarding' page asking for a status update