# MCP Docmost Server
Model Context Protocol (MCP) server for [Docmost](https://docmost.com/) - 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)
```bash
uvx mcp-docmost
```
### Using pip
```bash
pip install mcp-docmost
```
## Configuration
### Getting Auth Token
1. Login to Docmost in your browser
2. Open Developer Tools (F12) → Application → Cookies
3. Copy the `authToken` cookie value
### Add to Kiro MCP Config
Add to `.kiro/settings/mcp.json`:
```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
```bash
# Install dependencies
cd mcp-docmost
uv sync
# Run server directly
uv run python -m mcp_docmost.server
```
## License
MIT
