GroupDocs.Markdown

MCP server that exposes GroupDocs.Markdown as AI-callable tools for Claude, Cursor, GitHub Copilot, and other MCP agents — convert documents to clean, structured Markdown.

NuGet NuGet downloads Docker pulls MCP Registry Integration tests License: MIT

Installation

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 .NET 10 SDK.

Run directly with dnx (recommended — no install step):

dnx GroupDocs.Markdown.Mcp --yes

Pulls the latest stable release on every invocation. To pin to a specific version (recommended for shared configs and CI), append @<version>:

dnx [email protected] --yes

Or install as a global dotnet tool:

dotnet tool install -g GroupDocs.Markdown.Mcp
groupdocs-markdown-mcp

Or run via Docker:

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

No native prerequisites are required on any platform — the underlying GroupDocs.Markdown engine renders image-bearing documents through a self-contained SkiaSharp native asset, so dnx, the global tool, and the Docker image all run with no extra apt/brew setup.

Available MCP Tools

Tool	Description
ConvertToMarkdown	Converts a document (PDF, DOCX, XLSX, EPUB, MOBI, …) to clean, structured Markdown and saves the .md to storage. Images embed as base64 by default.
GetDocumentInfo	Returns file format, page count, title, author, and encryption flag as JSON, without converting.

Reverse Markdown → document composition is not yet implemented in the underlying GroupDocs.Markdown 26.3.0 engine (MarkdownConverter.FromMarkdownString throws NotImplementedException), so this server does not expose a ComposeFromMarkdown tool. Use the GroupDocs.Conversion MCP with a .md source file if you need Markdown → DOCX / PDF / HTML output today.

Example prompts for AI agents

• "Convert report.pdf to Markdown"
• "Export business-plan.docx as Markdown with images embedded as base64"
• "Convert pages 1-3 of contract.pdf to Markdown, text only — skip images"
• "How many pages does business-plan.pdf have?"
• "What format and author does cost-analysis.xlsx have?"

Licensing

The MCP server itself is MIT; the underlying GroupDocs.Markdown engine requires a license for production use. Without one the server runs in evaluation mode:

• Output may be limited and carries an evaluation notice.
• A single server process can open at most 15 documents; further calls fail with an evaluation-cap error until the server restarts.

To lift the limits, point GROUPDOCS_LICENSE_PATH at your GroupDocs.Total.lic:

• Get a free 30-day temporary license
• Purchase a license | Product page

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)

In evaluation mode (no license) the converted Markdown may be limited and can include an evaluation notice. Supply GROUPDOCS_LICENSE_PATH for unrestricted output.

Usage with Claude Desktop

{
  "mcpServers": {
    "groupdocs-markdown": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Markdown.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}

To pin to a specific version, replace "GroupDocs.Markdown.Mcp" with "[email protected]" in args. Pinning is recommended for shared / committed configs to avoid surprise upgrades.

Usage with VS Code / GitHub Copilot

NuGet.org generates a ready-to-use mcp.json snippet on the package page. Copy it directly into your .vscode/mcp.json.

Alternatively, add manually to .vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "storage_path",
      "description": "Base folder for input and output files.",
      "password": false
    }
  ],
  "servers": {
    "groupdocs-markdown": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Markdown.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "${input:storage_path}"
      }
    }
  }
}

Same pinning rule as above — swap "GroupDocs.Markdown.Mcp" for "[email protected]" to lock to a specific release.

Usage with Docker Compose

cd docker
docker compose up

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.Markdown.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