docannote-mcp

MCP server for DocAnnote — lets Claude read, edit, and annotate HTML documents stored in your DocAnnote workspace.

What is DocAnnote?

DocAnnote is a local-first HTML annotation platform. You import HTML files, pin comment threads at specific positions, and then Claude (via this MCP server) reads those comments, edits the HTML to address them, and marks threads as resolved — all in real time.

Quick setup (Claude Code CLI)

Run this once in your terminal:

claude mcp add docannote -e DOCANNOTE_URL=https://docannote-production.up.railway.app -- npx -y docannote-mcp

That's it. No cloning, no path configuration, no JSON editing.

Claude Desktop setup

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json, then restart Claude:

{
  "mcpServers": {
    "docannote": {
      "command": "npx",
      "args": ["-y", "docannote-mcp"],
      "env": {
        "DOCANNOTE_URL": "https://docannote-production.up.railway.app"
      }
    }
  }
}

Self-hosted backend

If you're running DocAnnote locally, replace the DOCANNOTE_URL value with your local address:

claude mcp add docannote -e DOCANNOTE_URL=http://localhost:3001 -- npx -y docannote-mcp

Available tools

| Tool | Description | |------|-------------| | get_full_context | Start here. Returns HTML + all open comment threads + version history in one call. | | list_documents | List all documents with IDs, names, open comment counts, and version counts. | | get_document | Get current HTML content and metadata for a document. | | get_comments | Get comment threads for a document, optionally filtered by status (open, resolved, all). | | update_document | Save new HTML content. Auto-creates a version snapshot and notifies connected browsers live. | | resolve_comment | Mark a comment thread as resolved after addressing it. | | add_comment | Pin a new comment at a position (x/y as % of preview area). | | create_document | Import a new HTML document into DocAnnote. | | get_version_history | Get full version history for a document, newest first. | | restore_version | Restore an older version as the new HEAD (non-destructive). |

Typical workflow

1. Open docannote.vercel.app and import an HTML file
2. Switch to Comment mode, click or select text to add comment threads
3. Tell Claude: "Look at doc <id> in DocAnnote and apply all the open comments."
4. Claude calls get_full_context → edits the HTML → calls update_document → calls resolve_comment for each thread addressed
5. Your browser updates live via WebSocket

Environment variables

| Variable | Default | Description | |----------|---------|-------------| | DOCANNOTE_URL | http://localhost:3000 | URL of the DocAnnote backend |

Requirements

• Node.js 18+
• A running DocAnnote backend (hosted at docannote-production.up.railway.app or self-hosted)