Merger for .NET Merger for Java Merger for Node.js Merger for Python
Merger for AI Agents (MCP)

Merge and split documents with AI agents via MCP server

Ask Claude, Cursor or Copilot to combine documents into one file or pull out the pages you need. The GroupDocs engine does the assembly on your machine, in 30+ formats.
NuGet Download Start Free Trial
One-click install: VS CodeCursorAll clients
Version 26.9.0  released
See what’s new

Merge PDF files with an AI agent

More examples >
{
  "mcpServers": {
    "groupdocs-merger": {
      "command": "dnx",
      "args": ["GroupDocs.Merger.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents"
      }
    }
  }
}
Then ask: Merge contractA.pdf, annex1.pdf and annex2.pdf into one file
dnx GroupDocs.Merger.Mcp --yes

GroupDocs.Merger MCP server at a glance

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

Illustration merger

The agent plans, the engine assembles

The agent works out the order, the page ranges and how to chain the calls. GroupDocs.Merger joins and splits the files with formatting and page layout intact.

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.Merger 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.Merger MCP server works with the following file formats.

Microsoft Office formats

  • Word: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT
  • Excel: XLS, XLSX, XLSM, XLSB, XLTM, XLTX, XLT, XLAM
  • PowerPoint: PPT, PPTX, PPS, PPSX, ODP, OTP
  • Visio: VSDX, VSDM, VSSX, VSTX, VSTM, VSSM, VSX, VTX, VDX

Documents & images

  • Documents: PDF, XPS, TEX
  • Images: BMP, JPEG, PNG, GIF, TIFF, SVG, PS
  • OpenDocument: ODT, OTT, ODS
  • eBook: EPUB

Other formats

  • Web: HTML, MHTML, MHT
  • Archives: ZIP, TAR, RAR, 7Z, BZ2, GZ
  • OneNote: ONE

What the MCP server can do

Combine, split and reassemble documents in 30+ formats from a single prompt

Feature icon

Merge documents

The merge tool combines two to four files per call, and the agent chains calls to assemble packs of any size.

Feature icon

Split into pages

The split tool saves the pages you name as separate documents.

Feature icon

Extract pages in bulk

Pull page 1, or the last page, out of every document in a folder with one prompt.

Feature icon

Reassemble in any order

Extract pages 3, 6 and 8 and merge them back in the order you ask for.

Feature icon

Document packs

Build onboarding, tender or closing packs from a folder in file-name order.

Feature icon

Page count first

The get_document_info tool returns file type, page count and page sizes, so the agent picks valid ranges.

Feature icon

PDF, Word, Excel, PowerPoint

Works with PDF, DOCX, XLSX, PPTX and 30+ more document formats.

Feature icon

Protected documents

Pass a password to split encrypted source files.

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.Merger MCP scenarios, each with the prompt that drives it

Merge any number of documents

Each merge call takes up to four files. The agent plans the batches, chains each result into the next call and tells you the final file name. Step by step: guide and blog walkthrough.

Prompt

There are nine PDFs. Merge them four at a time, chaining each result
into the next call, and tell me the final file name.

Split a document and keep the pages you need

Pull specific pages out of a long report and, if you like, merge them back into a short extract in your order. Step by step: guide and blog walkthrough.

Prompt

Extract pages 3, 6 and 8 of report.pdf,
then merge the three results into one file in that order

Assemble a document pack

Closing sets, tenders and onboarding packs are folders turned into one file. The agent merges them in file-name order and reports the page count of the result. Step by step: guide and blog walkthrough.

Prompt

Merge every PDF in my documents folder into one pack, in file-name order.
How many pages does the final pack have?

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-merger:
    image: ghcr.io/groupdocs-merger/merger-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.
Claude Desktop Claude Code VS Code Cursor Docker
{
  "mcpServers": {
    "groupdocs-merger": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Merger.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}

claude mcp add groupdocs-merger \
  -e GROUPDOCS_MCP_STORAGE_PATH=/path/to/documents \
  -- dnx GroupDocs.Merger.Mcp --yes

{
  "servers": {
    "groupdocs-merger": {
      "type": "stdio",
      "command": "dnx",
      "args": ["GroupDocs.Merger.Mcp", "--yes"],
      "env": {
        "GROUPDOCS_MCP_STORAGE_PATH": "/path/to/documents",
        "GROUPDOCS_LICENSE_PATH": ""
      }
    }
  }
}

{
  "mcpServers": {
    "groupdocs-merger": {
      "command": "dnx",
      "args": ["GroupDocs.Merger.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-merger/merger-net-mcp:latest

Ready to get started?

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

Useful resources

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

Documentation
API reference
Code samples
Free support
Paid support

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.
Go to license
✕