io.github.groupdocs-total/groupdocs-total-mcp
MCP server for GroupDocs.Total — annotate, sign, convert, watermark, parse, redact documents via AI.
Open source Open in the app JSON README (API)
About
MCP server for GroupDocs.Total — annotate, sign, convert, watermark, parse, redact documents via AI.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- groupdocs-total
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 26.7.3
- Last push
- 2026-09-03T09:39:09Z
- Repository state
- ativo
- Language
- C#
- License
- MIT
- Added
- 2026-08-29 03:02:54
- Updated
- 2026-08-29 03:02:54
- Origin id
io.github.groupdocs-total/groupdocs-total-mcp
README
# GroupDocs.Total MCP Server
Unified MCP server that exposes the full [GroupDocs.Total](https://products.groupdocs.com/total) document-processing toolset — annotation, comparison, conversion, markdown, merging, metadata, parsing, redaction, signing, watermarking, plus cross-product document inspection and page preview — as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents. Designed to be used **standalone** — attaching the individual product MCPs (GroupDocs.Annotation.Mcp, GroupDocs.Signature.Mcp, …) alongside is unnecessary and would duplicate tools.
[](https://github.com/orgs/groupdocs-total/packages/container/package/total-net-mcp)
[-6f42c1)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.groupdocs-total/groupdocs-total-mcp)
[](https://github.com/groupdocs-total/GroupDocs.Total.Mcp.Tests/actions/workflows/integration.yml)
[](LICENSE)
<!-- TODO(manual): record 30s demo per improvement-plan M1 -->
<!--  -->
## Installation
<!-- install-buttons:start - generated by install/generate-install-links.ps1; do not edit by hand -->
[](https://vscode.dev/redirect/mcp/install?name=groupdocs-total&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2Fpath%2Fto%2Fdocuments%3A%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_STORAGE_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_OUTPUT_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_LICENSE_PATH%3D%22%2C%22ghcr.io%2Fgroupdocs-total%2Ftotal-net-mcp%3Alatest%22%5D%7D) [](https://insiders.vscode.dev/redirect/mcp/install?name=groupdocs-total&config=%7B%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22--rm%22%2C%22-i%22%2C%22-v%22%2C%22%2Fpath%2Fto%2Fdocuments%3A%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_STORAGE_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_MCP_OUTPUT_PATH%3D%2Fdata%22%2C%22-e%22%2C%22GROUPDOCS_LICENSE_PATH%3D%22%2C%22ghcr.io%2Fgroupdocs-total%2Ftotal-net-mcp%3Alatest%22%5D%7D&quality=insiders) [](https://cursor.com/en/install-mcp?name=groupdocs-total&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItLXJtIiwiLWkiLCItdiIsIi9wYXRoL3RvL2RvY3VtZW50czovZGF0YSIsIi1lIiwiR1JPVVBET0NTX01DUF9TVE9SQUdFX1BBVEg9L2RhdGEiLCItZSIsIkdST1VQRE9DU19NQ1BfT1VUUFVUX1BBVEg9L2RhdGEiLCItZSIsIkdST1VQRE9DU19MSUNFTlNFX1BBVEg9IiwiZ2hjci5pby9ncm91cGRvY3MtdG90YWwvdG90YWwtbmV0LW1jcDpsYXRlc3QiXX0%3D) [](install/generated/codex.md) [](install/generated/windsurf.md)
> One-click installs pre-fill every supported setting: edit the placeholder host path in
> the volume mount after install; an empty GROUPDOCS_LICENSE_PATH runs in evaluation mode.
>
> **More clients** - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022,
> Cursor, Windsurf, Cline, and JetBrains Rider live in [`install/generated/`](install/generated/).
<!-- install-buttons:end -->
**This product ships via Docker (GHCR) only.** GroupDocs.Total bundles every engine (including Parser's embedded ONNX models), so the packed tool far exceeds NuGet.org's 250 MB limit - so `dnx` and
`dotnet tool install` are **not available** for it. When upstream ships a
slimmer engine that packs under the limit, the standard NuGet flow returns
(see the revert notes in `.github/workflows/publish_prod.yml`).
```bash
docker run --rm -i \
-v $(pwd)/documents:/data \
ghcr.io/groupdocs-total/total-net-mcp:latest
```
Images are multi-arch (`linux/amd64` + `linux/arm64`), tagged `latest` plus an
immutable version tag per release (e.g. `:26.9.0`). To pin, replace `:latest`
with the version tag - recommended for shared configs and CI.
## Available MCP Tools (38 total)
Tools follow `{Product}{Verb}{Noun}` PascalCase to disambiguate across domains. Cross-product tools stay short.
### Cross-product (2)
| Tool | Description |
|---|---|
| `GetDocumentInfo` | File type, page count, size as JSON for any document (170+ formats via Parser engine) |
| `GetDocumentPageImage` | Render up to 5 pages as inline PNG images (Viewer engine, 170+ formats) |
### Annotation (8)
| Tool | Description |
|---|---|
| `AnnotationAddAnnotation` | Add textfield / area / point / arrow / highlight / underline / strikeout annotation |
| `AnnotationGetAnnotations` | List all annotations as JSON (id, type, message, page, box, user, replies) |
| `AnnotationUpdateAnnotation` | Modify an existing annotation's message and/or bounding box by id |
| `AnnotationRemoveAnnotations` | Remove annotations by id list, or all |
| `AnnotationAddReply` | Add a reply / comment thread to an existing annotation |
| `AnnotationRemoveReplies` | Remove replies by id, by user name, or all |
| `AnnotationImportAnnotations` | Import annotations from XML or another annotated document |
| `AnnotationExportAnnotations` | Extract annotations to XML (re-importable via Import) |
### Signature (7)
| Tool | Description |
|---|---|
| `SignatureSign` | Sign with text / qrcode / barcode / digital certificate signature |
| `SignatureVerify` | Verify signatures, return JSON validity report |
| `SignatureSearchTextSignatures` | Find embedded text signatures with optional substring filter |
| `SignatureSearchBarcodes` | Find barcode signatures with optional decoded-text filter |
| `SignatureSearchQrCodes` | Find QR code signatures with optional decoded-text filter |
| `SignatureSearchDigitalSignatures` | Find digital certificate signatures (signer, issuer, validity) |
| `SignatureSearchImageSignatures` | Find embedded image signatures, return as base64 PNGs |
### Comparison (1) · Conversion (2) · Markdown (2)
| Tool | Description |
|---|---|
| `ComparisonCompare` | Compare two documents, produce annotated diff document |
| `ConversionConvert` | Convert between PDF, Office, image, HTML, and 50+ more formats |
| `ConversionGetSupportedFormats` | List every output format the document can be converted TO |
| `MarkdownConvertToMarkdown` | Convert PDF / Office / EPUB / MOBI to clean Markdown |
| `MarkdownComposeFromMarkdown` | Compose DOCX / PDF / HTML from Markdown source |
### Merger (2) · Metadata (2)
| Tool | Description |
|---|---|
| `MergerMerge` | Combine up to 4 documents into one (PDF / Office / HTML / images) |
| `MergerSplit` | Split a document into separate files by page numbers |
| `MetadataReadMetadata` | Read all metadata properties (author, title, EXIF, XMP, IPTC, custom) as JSON |
| `MetadataRemoveMetadata` | Strip all metadata and save a clean copy |
### Parser (5) · Redaction (4) · Watermark (3)
| Tool | Description |
|---|---|
| `ParserExtractText` | Extract plain text (page-by-page or whole document) |
| `ParserExtractImages` | Extract embedded images and save them to storage |
| `ParserExtractTables` | Extract tables as Markdown or JSON |
| `ParserExtractMetadata` | Extract metadata fields (separate from MetadataReadMetadata; Parser-format-aware) |
| `ParserExtractBarcodes` | Find and decode embedded barcodes in document pages |
| `RedactionRedactText` | Redact text matching a regex with a replacement string |
| `RedactionRedactImageArea` | Black out a rectangular region of a document page |
| `RedactionRedactAnnotations` | Redact or delete annotations matching a regex |
| `RedactionEraseMetadata` | Strip metadata via the Redaction engine (handles formats Metadata can't) |
| `WatermarkAddWatermark` | Add a text watermark with configurable font, rotation, opacity |
| `WatermarkSearchWatermarks` | List existing watermarks (type, text, position, page) as JSON |
| `WatermarkRemoveWatermarks` | Remove watermarks by text filter or all |
## Example prompts
- "Convert contract.docx to PDF, then sign it with a QR code containing 'Signed by Alice', then watermark every page with 'CONFIDENTIAL'"
- "Compare old.pdf and new.pdf, list every annotation in the result, and preview page 1"
- "Extract all tables from report.xlsx as Markdown and redact every email address"
- "Read the metadata of every PDF in /uploads, then strip it, then preview the cleaned page 1 of each"
- "Find every barcode in invoice.pdf, then merge invoice.pdf + receipt.pdf into combined.pdf"
## Licensing
**The MCP server itself is MIT; the underlying GroupDocs engines require a license
for production use.** Without one the server runs in **evaluation mode**:
- Each bundled engine applies its own evaluation limits: output watermarks / evaluation notices, page limits, and per-process document-open caps (1-15 documents depending on the engine).
To lift the limits, mount your `GroupDocs.Total.lic` into the container and point
`GROUPDOCS_LICENSE_PATH` at it (see the Claude Desktop example above):
- [Get a free 30-day temporary license](https://purchase.groupdocs.com/temporary-license/)
- [Purchase a license](https://purchase.groupdocs.com/pricing/total/net) | [Product page](https://products.groupdocs.com/total/net/)
## Configuration
| Variable | Description | Default |
|---|---|---|
| `GROUPDOCS_MCP_STORAGE_PATH` | Base folder for input and output files | current directory |
| `GROUPDOCS_MCP_OUTPUT_PATH` | *(Optional)* separate folder for output files | `GROUPDOCS_MCP_STORAGE_PATH` |
| `GROUPDOCS_LICENSE_PATH` | Path to GroupDocs license file | (evaluation mode) |
## Usage with Claude Desktop
```json
{
"mcpServers": {
"groupdocs-total": {
"command": "docker",
"args": ["run", "--rm", "-i", "-v", "/path/to/documents:/data", "ghcr.io/groupdocs-total/total-net-mcp:latest"]
}
}
}
```
> To use a license, add `"-v", "/path/to/license-folder:/license", "-e",
> "GROUPDOCS_LICENSE_PATH=/license/GroupDocs.Total.lic"` before the image name.
> To pin a version, replace `:latest` with the release tag.
## Usage with VS Code / GitHub Copilot
Use the **Install in VS Code** button above, or add to `.vscode/mcp.json`
(also in [`install/generated/vscode-mcp.json`](install/generated/vscode-mcp.json)):
```json
{
"inputs": [
{
"type": "promptString",
"id": "storage_path",
"description": "Base folder for input and output files.",
"password": false
}
],
"servers": {
"groupdocs-total": {
"command": "docker",
"args": ["run", "--rm", "-i", "-v", "${input:storage_path}:/data", "ghcr.io/groupdocs-total/total-net-mcp:latest"]
}
}
}
```
## Usage with Docker Compose
```bash
cd docker
docker compose up
```
Edit `docker/docker-compose.yml` to point volumes at your local documents folder.
## License
MIT — see [LICENSE](LICENSE)
<!-- mcp-name: io.github.groupdocs-total/groupdocs-total-mcp -->