
Groupdocs Conversion Mcp
io.github.groupdocs-conversionPublished by GitHub account groupdocs-conversionv26.9.0Updated Oct 24, 2026
MCP server for GroupDocs.Conversion — convert, inspect, and list supported formats via AI agents.
Overview
A local MCP server that lets an AI assistant convert documents between 70+ formats, list possible target formats, and inspect file properties.
- What you can do
- Convert documents to PDF, DOCX, XLSX, PPTX, HTML, PNG, JPG and other formats, saving results to a storage folder. List every target format a given source document can be converted to. Read a document's file type, page count, author, title, dates and password-protection status. Check which licensing mode is active and, under metered billing, consumed and remaining credit.
- When to use it
- Useful when you want an assistant to turn local documents into another format, or to check what a file is and what it can become, without uploading files to a third-party service. A good fit for desktop workflows in Claude Desktop, Cursor, VS Code, Rider or similar MCP clients.
- Requirements
- Runs locally over stdio via dnx, a global dotnet tool, or Docker; native runs need the .NET 10 SDK, and Linux/macOS native runs also need libgdiplus. Set GROUPDOCS_MCP_STORAGE_PATH for input/output files and optionally GROUPDOCS_MCP_OUTPUT_PATH. A license needs GROUPDOCS_LICENSE_PATH, or metered keys GROUPDOCS_METERED_PUBLIC_KEY and GROUPDOCS_METERED_PRIVATE_KEY.
Installation
In SourceWeft
- Open Groupdocs Conversion Mcp in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
GroupDocs.Conversion MCP Server
Convert PDF, Word, Excel, PowerPoint, HTML, images, and 70+ document formats from Claude, Cursor, GitHub Copilot, and any other MCP agent — locally, your files never leave your machine.
[NuGet] [NuGet downloads] [Docker pulls] [MCP Registry] [Integration tests] [License: MIT]
Install in 60 seconds
[Install in VS Code] [Install in VS Code Insiders] [Add to Cursor] [Codex CLI setup] [Windsurf setup]
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):
Pulls the latest stable release on every invocation. To pin to a specific
version (recommended for shared configs and CI), append @<version>:
Claude Desktop
Add to claude_desktop_config.json:
To use a license, add
"GROUPDOCS_LICENSE_PATH": "/path/to/GroupDocs.Total.lic"toenv— omit it to run in evaluation mode.
Claude Code
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 — same shape as VS Code's.
This is the native path for .NET teams already in Visual Studio.
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-conversion -- dnx GroupDocs.Conversion.Mcp --yes, details ininstall/generated/codex.md.
Docker
Images are published to both GHCR (ghcr.io/groupdocs-conversion/conversion-net-mcp) and
Docker Hub (groupdocs/conversion-net-mcp) for linux/amd64 + linux/arm64, tagged
latest plus an immutable version tag matching each NuGet release (e.g. :26.9.0).
Global dotnet tool
Version pinning: in any snippet above, replace
"GroupDocs.Conversion.Mcp"with"[email protected]"to lock to a specific release. Pinning is recommended for shared / committed configs to avoid surprise upgrades.
Available MCP Tools
Licensing
The MCP server itself is MIT; the underlying GroupDocs.Conversion engine requires a license for production use. Without one the server runs in evaluation mode:
- Converted output carries an evaluation watermark, and tool responses include an evaluation-mode notice.
- A single server process can open at most 15 documents; further calls fail with "Could not open more than 15 document files in evaluation mode" until the server restarts.
There are two ways to license the server.
License file — point GROUPDOCS_LICENSE_PATH at your GroupDocs.Total.lic. Works offline.
Metered (pay-per-use) — set both GROUPDOCS_METERED_PUBLIC_KEY and
GROUPDOCS_METERED_PRIVATE_KEY. You are billed for what you actually process, which suits AI
agents well because their usage is bursty and hard to predict up front. 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.
Call the get_license_status tool at any time to see which mode is active, and — under
metered — the consumed quantity and remaining credit.
Keeping the private key out of your config
The metered private key is a secret. MCP client configs are plain files on disk, 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, so this works in every client.
On macOS note that an app launched from Finder does not inherit shell exports — use
launchctl setenv, or 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:
To lift the limits with a license file: commented example in each install snippet above):
Configuration
Native prerequisites
The underlying GroupDocs engine uses System.Drawing (GDI+) for some
operations. When you run the server natively (via dnx or the global
dotnet tool) on Linux or macOS, install the native libgdiplus library first:
Skipping this on Linux/macOS surfaces as DllNotFoundException: libgdiplus in
the tool response. The simplest zero-setup option on Linux/macOS is the
Docker image.
Usage with Docker Compose
Edit docker/docker-compose.yml to point volumes at your local documents folder.
Documentation & guides
Step-by-step deployment guides and a published-package integration test suite live in the companion repo GroupDocs.Conversion.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
That repo also exercises every advertised tool against the published NuGet artifact on Linux, macOS, and Windows in CI — so the snippets above are verified end-to-end on every release.
License
MIT — see LICENSE
Source: README.md at commit 965e94b
Tools
0Version history
1- v26.9.0LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts