GroupDocs.Total MCP server
Commit Sep 3, 2026Enables AI agents to annotate, sign, convert, redact, and parse over 170 document formats via a unified toolset.
Also known as groupdocs-total/GroupDocs.Total.Mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 26.7.3
- Last commit
- Sep 3, 2026
- License
- MIT
What is GroupDocs.Total MCP?
GroupDocs.Total enables AI agents to annotate, sign, convert, redact, and parse over 170 document formats via a unified toolset.
Summary generated from the project's README
About GroupDocs.Total MCP server
Developers and AI agents that need to manipulate complex files can use this toolset to process over 170 document formats. It provides a unified interface for tasks like converting files between PDF, Office, and HTML, or extracting tables as Markdown and JSON. The server is designed to run as a standalone Docker container, making it compatible with clients like Claude, Cursor, and GitHub Copilot without needing to install individual product modules separately.
Users interact with 38 specific tools to perform actions such as adding text watermarks, signing documents with QR codes, or redacting sensitive information using regex. The system can also merge up to four documents, split files by page, and compare two documents to produce an annotated diff. Because the package includes heavy engines and ONNX models, it is distributed exclusively via Docker rather than NuGet.
Setup requires mounting local directories for storage and output via volume mounts. While the MCP server is MIT licensed, the underlying engines run in an evaluation mode with page and document limits unless a license file is provided through the GROUPDOCS_LICENSE_PATH environment variable.
What you can do with it
- 1Automated document signing and watermarkingAn AI agent can convert a Word document to PDF, apply a QR code signature, and add a confidential watermark to every page.
- 2Data extraction and sensitive info redactionA developer can instruct an agent to pull all tables from an Excel spreadsheet into Markdown format while redacting email addresses.
- 3Document comparison and visual inspectionYou can ask an AI to compare two PDF files, generate a list of all annotations in the diff, and show a preview of the first page.
- 4Metadata management and cleaningAn agent can scan a directory for PDF files, read their metadata, and then strip that metadata to create clean copies.
Written from the project's README. Every use case is checked against a quote from it.
How to install GroupDocs.Total MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall GroupDocs.Total MCP in Claude Code
$ claude mcp add groupdocs-total-mcp -- docker run -i --rm ghcr.io/groupdocs-total/total-net-mcp:26.7.3Install GroupDocs.Total MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"groupdocs-total-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/groupdocs-total/total-net-mcp:26.7.3"
]
}
}
}Install GroupDocs.Total MCP in VS Code
.vscode/mcp.json
{
"servers": {
"groupdocs-total-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/groupdocs-total/total-net-mcp:26.7.3"
]
}
}
}Install GroupDocs.Total MCP in VS Code CLI
$ code --add-mcp '{"name":"groupdocs-total-mcp","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/groupdocs-total/total-net-mcp:26.7.3"]}'Install GroupDocs.Total MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"groupdocs-total-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/groupdocs-total/total-net-mcp:26.7.3"
]
}
}
}Install GroupDocs.Total MCP in Codex
$ codex mcp add groupdocs-total-mcp -- docker run -i --rm ghcr.io/groupdocs-total/total-net-mcp:26.7.3Install GroupDocs.Total MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.groupdocs-total-mcp] command = "docker" args = ["run", "-i", "--rm", "ghcr.io/groupdocs-total/total-net-mcp:26.7.3"]
Install GroupDocs.Total MCP in Gemini CLI
$ gemini mcp add -s user groupdocs-total-mcp docker -- run -i --rm ghcr.io/groupdocs-total/total-net-mcp:26.7.3Install GroupDocs.Total MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"groupdocs-total-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/groupdocs-total/total-net-mcp:26.7.3"
]
}
}
}Configuration
GROUPDOCS_LICENSE_PATHGROUPDOCS_MCP_OUTPUT_PATHGROUPDOCS_MCP_STORAGE_PATH
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegroupdocs-total/groupdocs.total.mcp is public and reachablegithub.com/groupdocs-total/groupdocs.total.mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-03github.com/groupdocs-total/groupdocs.total.mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubGroupDocs.Total MCP Server
Unified MCP server that exposes the full GroupDocs.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.
Installation
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/.
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).
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):
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
{
"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:latestwith 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):
{
"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
cd docker
docker compose up
Edit docker/docker-compose.yml to point volumes at your local documents folder.
License
MIT — see LICENSE
GroupDocs.Total MCP questions
How do I add GroupDocs.Total MCP to Claude Code?
Run claude mcp add groupdocs-total-mcp -- docker run -i --rm ghcr.io/groupdocs-total/total-net-mcp:26.7.3 in your terminal. Add --scope user to make it available in every project.
How do I add GroupDocs.Total MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I install the GroupDocs.Total MCP server?
The product ships via Docker (GHCR) only. You can run it using a docker run command or use the one-click install buttons for VS Code and Cursor.
What document formats are supported?
The server supports over 170 formats through its Parser and Viewer engines.