Allows AI agents to edit Word, Excel, PowerPoint, and PDF documents by converting them to HTML and back while preserving formatting.
Also known as groupdocs-editor/GroupDocs.Editor.Mcp
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- 26.10.0
- Last commit
- Nov 1, 2026
- License
- MIT
What is GroupDocs.Editor MCP?
GroupDocs.Editor allows AI agents to edit Word, Excel, PowerPoint, and PDF documents by converting them to HTML and back while preserving formatting. It exposes 8 tools, such as get_document_info, extract_html, save_from_html.
Summary generated from the project's README
About GroupDocs.Editor MCP server
Editing Word, Excel, PowerPoint, and PDF documents without losing formatting is what this server enables for AI agents. It allows users to perform complex document tasks like replacing text in place, filling Word form fields, or converting specific document parts—such as a single worksheet, slide, or PDF page range—into editable HTML and back again. This round-trip process ensures that the original structure and styling remain intact during the editing cycle.
Developers can run this server locally using the .NET 10 SDK or via Docker containers. It integrates with various MCP clients including Claude Desktop, Cursor, GitHub Copilot, Windsurf, and JetBrains Rider. The server operates on files within a specified storage path, and for security, files never leave your machine. While the server itself is MIT licensed, the underlying engine can be used in evaluation mode or activated with a license file or metered keys to remove processing limits and evaluation banners.
What you can do with it
- 1Replace text while preserving stylesAn AI agent can find and replace specific strings in a document using regex or literal matching without breaking the layout.
- 2Convert document parts to HTMLYou can instruct an agent to extract a single slide or worksheet as HTML to make it easier to manipulate.
- 3Automate Word form completionThe server can identify and populate text boxes, checkboxes, and dropdowns within a Word document.
- 4Convert documents to multiple formatsAn agent can take an edited HTML file and save it as a PDF, DOCX, or even an EPUB.
Written from the project's README. Every use case is checked against a quote from it.
GroupDocs.Editor MCP tools 8
Detected from the READMEget_document_infoextract_htmlsave_from_htmlreplace_textget_supported_formatsget_form_fieldsfill_form_fieldsget_license_status
| get_document_info | — | |
| extract_html | — | |
| save_from_html | — | |
| replace_text | — | |
| get_supported_formats | — | |
| get_form_fields | — | |
| fill_form_fields | — | |
| get_license_status | — |
Configuration
GROUPDOCS_LICENSE_PATHGROUPDOCS_MCP_OUTPUT_PATHGROUPDOCS_MCP_STORAGE_PATHGROUPDOCS_METERED_PRIVATE_KEYGROUPDOCS_METERED_PUBLIC_KEY
| Name | Description | |
|---|---|---|
| GROUPDOCS_LICENSE_PATH | — | |
| GROUPDOCS_MCP_OUTPUT_PATH | — | |
| GROUPDOCS_MCP_STORAGE_PATH | — | |
| GROUPDOCS_METERED_PRIVATE_KEY | — | |
| GROUPDOCS_METERED_PUBLIC_KEY | — |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubGroupDocs.Editor MCP Server
Let Claude, Cursor, GitHub Copilot and any other MCP agent edit Word, Excel, PowerPoint, PDF and text documents without wrecking their formatting — replace text in place, round-trip a document (or one worksheet, slide or PDF page range) through editable HTML, and fill Word form fields. Locally: your files never leave your machine.
Install in 60 seconds
One-click installs pre-fill every supported setting: edit the placeholder documents folder after install (output defaults to the same folder); an empty GROUPDOCS_LICENSE_PATH runs in evaluation mode - point it at your license to lift limits.
More clients - ready-made configs for Claude Code, Codex CLI, Visual Studio 2022, Cursor, Windsurf, Cline, and JetBrains Rider live in
install/generated/.
Requires the .NET 10 SDK for native runs — or skip straight to Docker.
Run directly with dnx (recommended — no install step):
dnx GroupDocs.Editor.Mcp --yes
Pulls the latest stable release on every invocation. To pin a version (recommended for shared
configs and CI), append @<version>:
dnx GroupDocs.Editor.Mcp@26.10.0 --yes
The server reads and writes documents in GROUPDOCS_MCP_STORAGE_PATH (default: the current
directory). Edited copies are saved next to the originals and never overwrite an existing file.
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"groupdocs-editor": {
"type": "stdio",
"command": "dnx",
"args": ["GroupDocs.Editor.Mcp", "--yes"],
"env": {
"GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
}
}
}
}
To use a license, add
"GROUPDOCS_LICENSE_PATH": "/path/to/GroupDocs.Editor.lic"toenv— omit it to run in evaluation mode.
Claude Code
claude mcp add groupdocs-editor -- dnx GroupDocs.Editor.Mcp --yes
VS Code / GitHub Copilot
Use the Install in VS Code button above, or copy the ready-made snippet from the
NuGet package page into .vscode/mcp.json,
or take install/generated/vscode-mcp.json from this repo.
Visual Studio 2022 (17.14+)
Create .mcp.json in your solution root with the contents of
install/generated/vs2022-mcp.json.
Cursor · Windsurf · Cline · Rider · Codex
- Cursor — use the Add to Cursor button above, or paste
install/generated/claude-desktop.jsoninto~/.cursor/mcp.json. - Windsurf — follow
install/generated/windsurf.md. - Cline — paste
install/generated/cline.jsoninto Cline's MCP settings. - JetBrains Rider — follow
install/generated/rider.md. - Codex CLI —
codex mcp add groupdocs-editor -- dnx GroupDocs.Editor.Mcp --yes, details ininstall/generated/codex.md.
Docker
docker run --rm -i \
-v "$(pwd)/documents:/data" \
ghcr.io/groupdocs-editor/editor-net-mcp:latest
Images are published to GHCR (ghcr.io/groupdocs-editor/editor-net-mcp) and Docker Hub
(groupdocs/editor-net-mcp) for linux/amd64 + linux/arm64, tagged latest plus an immutable
version tag matching each NuGet release (e.g. :26.10.0). The image needs no native setup.
Docker on Linux: run the container as your user
The image runs as a non-root user (uid 1654), and a bind mount keeps its host owner — so on a
Linux host every edited file the server writes into /data fails with Permission denied
unless the container runs as you:
docker run --rm -i --user "$(id -u):$(id -g)" \
-v "$(pwd)/documents:/data" \
ghcr.io/groupdocs-editor/editor-net-mcp:latest
JSON client configs run no shell, so put the numbers in: "args": ["run", "--rm", "-i", "--user", "1000:1000", …]. Docker Desktop on Windows and macOS does not need this.
Global dotnet tool
dotnet tool install -g GroupDocs.Editor.Mcp
groupdocs-editor-mcp
Available MCP Tools
| Tool | What it does |
|---|---|
get_document_info |
Format family, format, number of pages / worksheets / slides, size, encryption, and the formats it can be saved to (JSON) |
extract_html |
Turns a document — or one worksheet, one slide, or a PDF page range — into editable HTML saved to storage, plus a plain-text preview. Self-contained by default; embedResources=false writes a <name>_resources folder |
save_from_html |
Saves edited HTML back as DOCX, DOC, RTF, ODT, XLSX, XLS, ODS, CSV, PPTX, PPT, ODP, PDF, XPS, TXT, Markdown, MHTML, EPUB, MOBI, AZW3, EML or MSG. With sourceFile + worksheet/slide it splices one edited part back into the original and keeps every other part |
replace_text |
Find and replace that keeps formatting — literal, case-insensitive, whole-word or regex; one worksheet or slide at a time; optional output format. Reports how many occurrences changed; writes nothing when nothing matched |
get_supported_formats |
The formats GroupDocs.Editor can open and save, per family, or the save targets of one file (JSON) |
get_form_fields |
Lists a Word document's form fields — text boxes, check boxes, drop-downs, number and date fields — with type and value (JSON) |
fill_form_fields |
Fills Word form fields and saves a filled copy; unknown names and values that do not fit are reported, never ignored |
get_license_status |
Licensing mode, metered consumption and engine version (shipped by GroupDocs.Mcp.Core) |
Worksheet, slide and page numbers are 1-based. Every failure sets isError and starts with the
tool's prefix, e.g. HTML extraction failed for 'report.docx': …, so a client needs one check.
Example prompts for AI agents
Replace "ACME Corp" with "Globex" in contract.docx and keep the formatting.
Give me the second worksheet of budget.xlsx as HTML so I can edit it.
Save edited.html back as a Word document, and also as a PDF.
Fill the form fields in application.docx: name = Jane Doe, agree = yes.
Which formats can GroupDocs.Editor open and save?
Evaluation mode
The MCP server itself is MIT; the GroupDocs.Editor engine requires a license for production use. Without one every tool still works, with these limits (measured on GroupDocs.Editor 26.6.1):
- Edited output starts with an evaluation banner ("Created with evaluation version of GroupDocs.Editor …").
- A saved workbook gains an extra worksheet.
- Only the first 2 pages of a PDF, the first 2 (visible) worksheets of a workbook and the first 2 slides of a presentation can be edited. The engine would silently return part 2 for a higher number; the server refuses the request instead and says why. Saving an edited part back into worksheet or slide 3+ is not limited.
Responses of the editing tools then start with one Evaluation mode: line. Call
get_license_status to see which mode is active.
Licensing
There are two ways to license the server.
License file — point GROUPDOCS_LICENSE_PATH at your GroupDocs.Editor (or GroupDocs.Total)
license file. Works offline.
Metered (pay-per-use) — set both GROUPDOCS_METERED_PUBLIC_KEY and
GROUPDOCS_METERED_PRIVATE_KEY. You pay for what you process, which suits agent workloads. If both a
metered key pair and a license file are configured, metered wins and the file is ignored.
Metered mode needs outbound connectivity. Usage is reported to GroupDocs servers, so air-gapped or firewalled deployments must allow that egress — or use a license file instead.
Keeping the private key out of your config
The metered private key is a secret. MCP client configs are plain files, and a project-scoped
.mcp.json is committed by convention, so prefer, in order:
- Set the variables in your OS environment and leave them out of the config entirely — an stdio
MCP server inherits its client's environment. On macOS an app launched from Finder does not
inherit shell exports; use
launchctl setenvor launch the client from a terminal. - Reference them indirectly if your client supports it (Claude Code expands
${VAR}; VS Code uses${env:VAR}and${input:...}). - A literal value in a user-scoped config (for example
~/.claude.json) is acceptable for a single developer. - Never commit a literal key in a project-scoped
.mcp.json.
For Docker, forward the values without writing them into any file:
docker run --rm -i \
-e GROUPDOCS_METERED_PUBLIC_KEY -e GROUPDOCS_METERED_PRIVATE_KEY \
-v /path/to/documents:/data \
ghcr.io/groupdocs-editor/editor-net-mcp:latest
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 a GroupDocs license file | (evaluation mode) |
GROUPDOCS_METERED_PUBLIC_KEY |
Metered public key. Requires the private key too; takes precedence over the license file | (unset) |
GROUPDOCS_METERED_PRIVATE_KEY |
Metered private key. Secret — see Licensing | (unset) |
Native prerequisites
GroupDocs.Editor draws through Aspose.Drawing (managed) and SkiaSharp, whose native libraries ship
inside the package — no libgdiplus is needed on any platform. Saving edited content to PDF or
XPS lays text out, so Linux needs real fonts:
| Platform | Setup |
|---|---|
| Windows | Nothing. |
| Linux | sudo apt-get install -y libfontconfig1 ttf-mscorefonts-installer (only for PDF/XPS output) |
| macOS | Nothing. |
| Docker | Nothing — the image bundles the fonts. |
Limits
replace_textmatches within one formatting run. A phrase split across differently formatted text (half bold, half not) is not matched; useextract_htmlandsave_from_htmlfor such edits.- PDF editing is a conversion. A PDF is turned into flowing HTML and back, so complex layouts do not round-trip perfectly. Save the edited result as DOCX if fidelity matters.
- PPTX and email outputs need an original.
save_from_htmlcreates DOCX, XLSX, PDF, TXT, Markdown and EPUB from HTML alone; for PPTX and EML/MSG pass the original assourceFile. - Remote resources. HTML or Office input that references remote images or stylesheets may cause the engine to fetch them while loading. Run the server without network egress if inputs are untrusted.
- macOS CI. Integration tests gate on Linux and Windows; the family-wide macOS runner hang is tracked separately.
Usage with Docker Compose
cd docker
docker compose up
Edit docker/docker-compose.yml to point the volume at your documents folder.
Documentation & guides
Step-by-step deployment guides and a published-package integration test suite live in the companion repo GroupDocs.Editor.Mcp.Tests:
- Install from NuGet —
dnx, global tool, pinned vs always-latest - Run via Docker
- Verify on the MCP registry
- Use with Claude Desktop
- Use with VS Code / GitHub Copilot
- Run the integration tests
- Use with Cursor
That repo exercises every advertised tool against the published package (dnx on Linux, Windows and macOS) and the Docker image, reading every edit back through the server.
License
MIT — see LICENSE
GroupDocs.Editor MCP questions
What tools does GroupDocs.Editor MCP provide?
It exposes 8 tools, including get_document_info, extract_html, save_from_html, replace_text, get_supported_formats.
Does my data leave my machine?
No, your files never leave your machine when running locally.
What happens if I don't provide a license?
The server runs in evaluation mode with certain limitations, such as an evaluation banner on output and limits on the number of pages or worksheets that can be edited.
How do I replace text without breaking the document layout?
The replace_text tool allows you to find and replace text using literal, case-insensitive, whole-word, or regex methods while keeping the original formatting.