# 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
