GroupDocs.Metadata MCP Server

GroupDocs.Metadata MCP server lets AI agents like Claude, Cursor, and Copilot read, edit, and strip metadata from documents and images — PDF, Office, images, audio, video and more — locally on your machine. The files stay where they are; only the properties change.

Run it with one command. The Docker image is self-contained — the runtime and every native dependency the engine needs are inside it:

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

With the .NET 10 SDK installed, the same server also runs without Docker:

dnx GroupDocs.Metadata.Mcp --yes

Both are the .NET build of the server and run on Windows, Linux, and macOS. Other platforms will each get their own launcher — see Install for your platform.

Or use the guided installer to register the server in your AI client, verify the setup, and configure shared folders in one pass.

What you can do

Six tools (full details in the tools reference):

  • read_metadata — every property in the file as JSON: author, title, dates, custom fields, EXIF, XMP, IPTC.
  • search_metadata — only the properties matching a category, name, or value filter.
  • write_metadata — set, change, or add one property and save the updated file.
  • remove_metadata — strip everything, or just the categories you name.
  • get_document_info — type, size, pages, encryption status, without enumerating properties.
  • get_license_status — which licensing mode is active and, under metered, how much has been consumed.

Ask in plain language — “who wrote this?”, “strip everything before I send it” — and the agent picks the tools.

Install for your platform

Installation, prerequisites, and client configuration are platform-specific; the tools and licensing model below are the same everywhere.

PlatformStatusInstall and setup
.NETAvailableMCP server for .NET
JavaPlannedTell us you need it
PythonPlannedTell us you need it
Node.jsPlannedTell us you need it
Warning
Read this before trusting a metadata audit. In evaluation mode the engine returns only the first five document properties, with reduced XMP and EXIF access — and nothing in the response says so. An unlicensed privacy check can report a clean file that is not clean. Confirm with get_license_status first; see Licensing.

Supported AI clients

ClientHow it connects
Claude Desktopclaude_desktop_config.json
Claude Codeclaude mcp add CLI
VS Code / GitHub Copilotuser-level or workspace mcp.json
Visual Studio 2022 (17.14+).mcp.json in the solution root
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
ClineCline MCP settings
Codex CLIcodex mcp add CLI
JetBrains Ridermanual registration (Settings → AI Assistant → MCP)

Exact config blocks for every client: Register in AI clients.

Delivery channels

Docker (recommended)NuGet (dnx)
PrerequisitesDocker only.NET 10 SDK (+ libgdiplus on Linux/macOS)
Native dependenciesbundled in the imageinstalled by you (or the setup script)
Packageghcr.io/groupdocs-metadata/metadata-net-mcpGroupDocs.Metadata.Mcp on NuGet
Architectureslinux/amd64 + linux/arm64 (Apple Silicon native)any OS with .NET 10

How it works

The server uses MCP’s local stdio transport: your AI client starts the server as a child process and talks to it over standard input/output. No inbound ports, no external endpoints, no telemetry — the data path is agent → local server → local filesystem. Metadata is exactly the kind of data you do not want to hand to a cloud service to inspect: it is where author names, machine names, GPS coordinates, and internal paths hide. Details: On-premise architecture.

When you need more than “File → Properties”

Every application shows a few properties for its own format. Choose this server when you need: one model across documents, images, audio, and video; the packages a UI hides (XMP, IPTC, EXIF including GPS); value search across every package at once; bulk edit and strip driven from a prompt rather than by hand; and the fidelity of the commercial GroupDocs engine trusted by enterprise teams for over a decade.

Resources