GroupDocs.Redaction MCP server at a glance

An MCP server that gives AI agents the GroupDocs.Redaction engine as tools they can call

Illustration redaction

Permanent redaction, verified

The agent turns a request such as remove all emails into precise patterns and steps. GroupDocs.Redaction removes the content from the file itself, and the agent can re-check the result before you share it.

Local by design

Your AI client starts the server as a local process over stdio. It opens no ports, sends no telemetry, and reads and writes only the folder you configure, so contracts, records and internal documents never leave your machine.

Works with every MCP client

Use it from Claude Desktop, Claude Code, VS Code with GitHub Copilot, Visual Studio 2022, Cursor, Windsurf, Cline, JetBrains Rider and Codex CLI. One-click installs and ready-made configurations are available for each client.

Runs where your agent runs

GroupDocs.Redaction MCP server works on Windows, Linux and macOS, natively with .NET 10 or in Docker

VS Code
Docker
NuGet
Windows
Linux
macOS
Azure
Amazon

NuGet package

  • One command with the .NET 10 SDK, no install step
  • Windows, Linux and macOS
NuGet download

Docker image

  • Nothing to install besides Docker
  • linux/amd64 and linux/arm64, native dependencies bundled
Get the image

VS Code and GitHub Copilot

  • One-click install with a pre-filled configuration
  • Set your documents folder after install
Install in VS Code

Cursor

  • One-click install with a pre-filled configuration
  • Runs in evaluation mode until you add a license
Add to Cursor

Supported file formats

GroupDocs.Redaction MCP server works with the following file formats.

MS Office Formats

  • Word: DOCX, DOC, DOCM, DOT, DOTX, DOTM
  • Excel: XLSX, XLS, XLSM, XLTX, XLTM, XLT, XLSB
  • PowerPoint: PPTX, PPT, PPSX, PPS, PPTM, POTX, PPSM, POTM

Other Office Formats

  • Portable: PDF
  • OpenDocument: ODT, OTT, ODS, OTS, ODP, OTP
  • Text Formats: RTF, CSV, TAB

Other Formats

  • Images: BMP, GIF, JPEG, PNG, TIFF, WEBP
  • eBooks: DJVU

What the MCP server can do

Redact text, image areas, annotations and metadata, then verify the result

Feature icon

Redact text by pattern

The redact_text tool removes text that matches a regex, such as emails, phone numbers or ID numbers.

Feature icon

Black out image areas

The redact_image_area tool covers faces, signatures or stamps with a solid box.

Feature icon

Clean annotations

The redact_annotations tool replaces or deletes comments, sticky notes and highlights.

Feature icon

Erase metadata

The erase_metadata tool removes author, company, keywords and dates from document properties.

Feature icon

Verify the result

Ask the agent to check the redacted copy for any remaining match before you share it.

Feature icon

Scans and images

Redact areas on scans and images where there is no text layer.

Feature icon

Disclosure and GDPR workflows

Chain text, annotation and metadata steps into one disclosure-ready copy.

Feature icon

Document info first

The get_document_info tool returns type, page count and page sizes for precise areas.

Feature icon

Flexible licensing

Start in evaluation mode, then use a license file or metered keys. The get_license_status tool shows which one is active.

What you can ask your agent

Typical GroupDocs.Redaction MCP scenarios, each with the prompt that drives it

Redact sensitive data by pattern

Describe what must go, and the agent writes the pattern. Email addresses, social security numbers or any custom identifier are removed from the document permanently. Step by step: guide and blog walkthrough.

Prompt

Redact every email address and every US social security number
in case-file.pdf

Prepare a document for disclosure

Disclosure needs several passes. The agent redacts names and emails, deletes annotations and clears document properties, each step working on the file the previous one produced. Step by step: guide and blog walkthrough.

Prompt

Prepare case-file.pdf for disclosure: redact all email addresses and the name Jane Smith,
delete all annotations and clear the document properties

Verify that a redaction is complete

Trust, then verify. The agent checks the redacted copy for any remaining match, any annotation and any leftover property before it leaves your hands. Step by step: guide and blog walkthrough.

Prompt

Check case-file_redacted.pdf: does any email address remain?
Are there annotations or document properties left?

Run on-premise with Docker

For regulated environments, run the server inside your perimeter. Mount the documents folder and the license, and pin the image version for change control. Architecture and security model: on-premise deployment.

docker-compose.yml

services:
  groupdocs-redaction:
    image: ghcr.io/groupdocs-redaction/redaction-net-mcp:26.9.0
    volumes:
      - "/srv/documents:/data"
      - "/srv/licenses:/license:ro"
    environment:
      GROUPDOCS_MCP_STORAGE_PATH: /data
      GROUPDOCS_LICENSE_PATH: /license/GroupDocs.Total.lic
    stdin_open: true

Install in your AI client

Copy the configuration for your client, or use the one-click links at the top of the page

Register the server

Every client starts the server the same way. Set GROUPDOCS_MCP_STORAGE_PATH to the folder with your documents, then restart the client. Leave GROUPDOCS_LICENSE_PATH empty for evaluation mode. Configurations for Visual Studio 2022, Windsurf, Cline, JetBrains Rider and Codex CLI are in the installation guide.
{
  "mcpServers": {
    "groupdocs-redaction": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Redaction.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}
claude mcp add groupdocs-redaction \
  -e GROUPDOCS_MCP_STORAGE_PATH=/path/to/documents \
  -- dnx GroupDocs.Redaction.Mcp --yes
{
  "servers": {
    "groupdocs-redaction": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Redaction.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}
{
  "mcpServers": {
    "groupdocs-redaction": {
      "command": "dnx",
      "args": ["GroupDocs.Redaction.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}
docker run --rm -i \
  -v /path/to/documents:/data \
  ghcr.io/groupdocs-redaction/redaction-net-mcp:latest

Ready to get started?

Download GroupDocs.Redaction for free or get a trial license for full access!

Useful resources

Explore documentation, code samples, and community support to enhance your experience.

Temporary license tips

1
Sign up with your work email.
Free mail services are not allowed.
2
Use Get a temporary license button on the second step.
✕