GroupDocs.Annotation MCP Server

GroupDocs.Annotation MCP server lets AI agents like Claude, Cursor, and Copilot annotate and review documents — PDF, Word, Excel, PowerPoint, images, and 50+ more formats — locally on your machine. Highlights, comments, arrows, strikeouts, and full reply threads, with nothing uploaded to any cloud service.

Run it with one command. The Docker image is self-contained — the runtime and every native dependency the engine needs are inside it:

docker run --rm -i -v $(pwd)/documents:/data \
  ghcr.io/groupdocs-annotation/annotation-net-mcp:latest

With the .NET 10 SDK installed, the same server also runs without Docker:

dnx GroupDocs.Annotation.Mcp --yes

Both are the .NET build of the server and run on Windows, Linux, and macOS. Other platforms will each get their own launcher — see Install for your platform.

Or use the guided installer to register the server in your AI client, verify the setup, and configure shared folders in one pass.

What you can do

Eleven tools, which fall into four groups (full details in the tools reference):

Readget_annotations lists every annotation as JSON (ids, types, pages, authors, replies); get_document_info returns pages and dimensions.

Writeadd_annotation adds a highlight, comment, arrow, area, point, underline, or strikeout; update_annotation edits one; remove_annotations deletes by id or clears all.

Discussadd_reply and remove_replies turn annotations into threads, with authors.

Move and showexport_annotations / import_annotations carry a round of comments to a new draft; generate_pages_preview renders pages as images the client displays inline.

Ask in plain language — “highlight the payment clause and ask legal to confirm”, “which comments are still unanswered?” — and the agent picks the tools.

Install for your platform

Installation, prerequisites, and client configuration are platform-specific; the tools and licensing model below are the same everywhere.

PlatformStatusInstall and setup
.NETAvailableMCP server for .NET
JavaPlannedTell us you need it
PythonPlannedTell us you need it
Node.jsPlannedTell us you need it

The agent can see what it annotated

Most document servers are write-only: the agent calls a tool and trusts the result. generate_pages_preview returns rendered PNGs inline, annotations included, so in a client with image support the agent can look at the page it just marked up, check the placement, and fix it before you ever open the file. Details: Let the agent see the page.

Supported AI clients

ClientHow it connects
Claude Desktopclaude_desktop_config.json
Claude Codeclaude mcp add CLI
VS Code / GitHub Copilotuser-level or workspace mcp.json
Visual Studio 2022 (17.14+).mcp.json in the solution root
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
ClineCline MCP settings
Codex CLIcodex mcp add CLI
JetBrains Ridermanual registration (Settings → AI Assistant → MCP)

Exact config blocks for every client: Register in AI clients.

Delivery channels

Docker (recommended)NuGet (dnx)
PrerequisitesDocker only.NET 10 SDK (+ libgdiplus on Linux/macOS)
Native dependenciesbundled in the imageinstalled by you (or the setup script)
Packageghcr.io/groupdocs-annotation/annotation-net-mcpGroupDocs.Annotation.Mcp on NuGet
Architectureslinux/amd64 + linux/arm64 (Apple Silicon native)any OS with .NET 10

How it works

The server uses MCP’s local stdio transport: your AI client starts the server as a child process and talks to it over standard input/output. No inbound ports, no external endpoints, no telemetry — the data path is agent → local server → local filesystem. Review comments are often more sensitive than the document itself; this keeps both on your machine. Details: On-premise architecture.

When you need more than a PDF viewer’s comments

A PDF reader can annotate a PDF. Choose this server when you need: the same annotation model across 50+ formats (Word, Excel, PowerPoint, images — not just PDF); annotations as structured data an agent can filter, count, and report on; threads with authors rather than loose notes; export/import so a review survives a new draft; and the fidelity of the commercial GroupDocs engine trusted by enterprise teams for over a decade.

Resources