@utilitly/mcp
This local MCP server lets an AI inspect and edit PDFs on your own computer, writing every result as a new file beside the original.
Inspect a PDF: page count, file size, first-page size, and password protection.
Merge multiple PDFs in a given order.
Split a PDF into multiple files by page ranges.
Extract selected pages into one new PDF.
Rotate pages clockwise or counter-clockwise by multiples of 90 degrees.
Delete selected pages while keeping at least one page.
Reorder every page into a new sequence.
Duplicate selected pages, either after each page or at the end.
Use absolute or
~/paths, with optional output paths/folders; existing files are never overwritten.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@utilitly/mcp Merge ~/Downloads/march.pdf and ~/Downloads/april.pdf and delete blank page 3."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@utilitly/mcp
A PDF MCP server for Claude, the ChatGPT desktop app, Codex, Gemini CLI, Cursor and any other app that can run a local MCP server. Ask your AI to merge, split, rotate, delete, reorder or duplicate pages, and it does the work with PDF files on your own computer.
The server runs locally, next to the AI app, and edits files where they sit. It's built on Utilitly's open-source PDF engines, ported from the free tools on utilitly.com, and it never replaces a file: every result is a new PDF beside the original.
Install
You need Node.js 22 or newer. The first run downloads the server through npx.
The folders after the package name are the only places the server may read and write. Change them to wherever your PDFs live.
Claude Code
claude mcp add utilitly -- npx -y @utilitly/mcp ~/Documents ~/Downloads ~/DesktopClaude Desktop: open Settings, then Developer, then Edit Config, and add this to claude_desktop_config.json. Restart Claude Desktop afterwards.
{
"mcpServers": {
"utilitly": {
"command": "npx",
"args": ["-y", "@utilitly/mcp", "~/Documents", "~/Downloads", "~/Desktop"]
}
}
}Cursor: put the same mcpServers block in ~/.cursor/mcp.json.
ChatGPT desktop app and Codex share one setup, so adding the server to either one adds it to both. In the ChatGPT app, open Settings, then MCP servers, then Add server. Choose STDIO, enter the command npx with the arguments -y @utilitly/mcp ~/Documents ~/Downloads ~/Desktop, save, and restart. From the Codex CLI:
codex mcp add utilitly -- npx -y @utilitly/mcp ~/Documents ~/Downloads ~/DesktopGemini CLI: everything after -- goes to npx, and -s user makes the server available in every folder you start Gemini in.
gemini mcp add -s user utilitly npx -- -y @utilitly/mcp ~/Documents ~/Downloads ~/DesktopAnything else that can start a local (stdio) MCP server: the command is npx with the arguments -y @utilitly/mcp, followed by the folders.
The server is also listed in the official MCP Registry as com.utilitly/mcp, so apps and directories that read the registry can find it by that name.
About the folder list
The check happens after symlinks are resolved, so a link inside an allowed folder can't lead somewhere else.
Leave the folders out and the server may use any file you can. It still never overwrites or deletes anything, and it never shows the AI what's inside a PDF. But an AI misled by something it read elsewhere could copy any of your PDFs into any folder, so list folders unless you need it everywhere.
Related MCP server: pdf-toolbox-mcp
Try it in 30 seconds
Once it's installed, ask in plain words and use full paths:
"Merge ~/Downloads/march.pdf and ~/Downloads/april.pdf."
"Delete the blank page 3 from ~/Desktop/scan.pdf."
"Split ~/Documents/handbook.pdf into pages 1-12, 13-30 and 31 to the end."
"Pages 2 to 4 of ~/Desktop/scan.pdf are sideways; turn them the right way up."
"How many pages does ~/Documents/contract.pdf have, and is it locked?"
Tools
Tool | What it does | New file it writes |
| Page count, file size, first page size, and whether the PDF is password-protected. Changes nothing. | none |
| Combines PDFs in the order given. |
|
| One file per range, e.g. |
|
| The selected pages as one PDF, in page order. |
|
| Turns pages by a multiple of 90 degrees. |
|
| Removes pages; at least one has to stay. |
|
| Puts every page in a new order. |
|
| Adds copies after each page or at the end. |
|
Results land in the same folder as the input. Every writing tool also takes an optional output_path, and split_pdf an optional output_folder. Page selections read like "2", "1-3, 5" or "4-end".
Problems come back to the AI as a short code and a sentence it can act on, such as NO_PAGES: "9" doesn't match any page. The PDF has 4 pages. or ENCRYPTED: File 2 is password-protected. Remove the password first, then try again.
What it can and can't touch
It never overwrites. If
report-merged.pdfalready exists, the result becomesreport-merged-2.pdf, and anoutput_paththat already exists is refused.Input files are only read, never changed.
Paths must be absolute or start with
~/, so the AI can't stumble into the wrong folder through a relative path.With folders listed at install, nothing outside them can be read or written.
Password-protected PDFs are refused rather than altered.
pdf_inforeports when a file is locked.One call can add at most 10,000 pages beyond what its input files hold, and one split writes at most 1,000 files (or one per page for longer PDFs). A mistaken request, like a hundred million copies, is refused before anything is built.
Why nothing is uploaded
The PDF work happens inside this server, on your machine, with no network code anywhere in it. test/network.test.ts proves that on every change: it makes opening a connection, looking up a host name and calling fetch all throw, then runs every tool, and they all succeed.
Your AI app still talks to its model as usual. That conversation includes whatever you type, file paths included, and each tool's short reply: the paths it wrote, page counts and file sizes. This server never puts the contents of a PDF into the conversation.
Good to know
merge_pdfs,split_pdf,extract_pages,delete_pages,reorder_pagesandduplicate_pagesbuild fresh PDFs, so bookmarks, document properties and working form fields aren't carried into the result.rotate_pdfkeeps the whole document.Images and fonts shared between pages stay shared, so results don't balloon in size.
To check what's running,
npx -y @utilitly/mcp --versionprints the version and--helpthe usage.
License
MIT. Built on the @utilitly PDF engines and pdf-lib (both MIT), and the official MCP TypeScript SDK (Apache-2.0).
Available Tools
8 toolsdelete_pagesDelete pagesA
Removes the selected pages and keeps the rest in order, named with -trimmed. At least one page must remain. Writes the result as a new file next to the input (or to output_path) and never replaces an existing file; the input is left unchanged.
Inputs: path (required), pages (required), output_path. Returns: pages, output_path
duplicate_pagesDuplicate pagesA
Adds copies of the selected pages, right after each one or all at the end, named with -duplicated. Copies share the page's images, so the file barely grows. One call can add at most 10,000 pages. Writes the result as a new file next to the input (or to output_path) and never replaces an existing file; the input is left unchanged.
Inputs: path (required), pages (required), copies, placement, +1 more. Returns: pages, output_path
extract_pagesExtract pagesA
Copies the selected pages into one new PDF, in page order, named with -pages. Writes the result as a new file next to the input (or to output_path) and never replaces an existing file; the input is left unchanged.
Inputs: path (required), pages (required), output_path. Returns: pages, output_path
merge_pdfsMerge PDFsA
Combines PDFs into one, in the order given. The result is named after the first file, with -merged. Writes the result as a new file next to the input (or to output_path) and never replaces an existing file; the input is left unchanged.
Inputs: paths (required), output_path. Returns: pages, output_path
pdf_infoPDF infoARead-onlyIdempotent
Reads a PDF and reports its page count, file size, first page size in points, and whether it is password-protected. Changes nothing.
Inputs: path (required). Returns: path, pages, encrypted, first_page, +1 more
reorder_pagesReorder pagesA
Puts the pages in a new order, named with -reordered. The order must list every page exactly once; use pdf_info for the page count. Writes the result as a new file next to the input (or to output_path) and never replaces an existing file; the input is left unchanged.
Inputs: path (required), order (required), output_path. Returns: pages, output_path
rotate_pdfRotate pagesA
Turns pages clockwise by a multiple of 90 degrees (negative turns counter-clockwise), every page unless pages is given. Named with -rotated. Writes the result as a new file next to the input (or to output_path) and never replaces an existing file; the input is left unchanged.
Inputs: path (required), angle (required), pages, output_path. Returns: pages, output_path
split_pdfSplit a PDFA
Splits a PDF into one new file per comma-separated range, named -part1, -part2 and so on. "1-2, 3-end" gives two files, and one call writes at most 1,000 (or one per page for longer PDFs). Never replaces an existing file; the input is left unchanged.
Inputs: path (required), ranges (required), output_folder. Returns: pages, output_paths
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool maps to a distinct page-level operation (merge, split, extract, rotate, delete, reorder, duplicate) plus a read-only info tool, and the descriptions clarify the outputs. The only mild overlap is split_pdf vs extract_pages, both of which produce page subsets, but the distinction (multiple range-based files vs one copied subset) is spelled out well enough.
Seven of eight tools follow a clean verb_noun pattern (merge_pdfs, split_pdf, extract_pages, rotate_pdf, delete_pages, reorder_pages, duplicate_pages). pdf_info breaks the pattern by putting the noun first, a minor deviation that is still readable and unambiguous.
Eight tools is well within the sweet spot for a focused PDF utility server, and each one corresponds to a meaningful, non-redundant operation. Nothing feels padded or missing at the count level.
The surface covers inspection plus the core structural editing lifecycle (merge, split, extract, rotate, delete, reorder, duplicate) with consistent output behavior. Gaps exist for common PDF tasks like text/content extraction, compression, and encryption or metadata editing, though these are workaroundable and outside the apparent structural-editing scope.
Related MCP Connectors
Merge, split, extract, rotate, reorder and stamp PDF pages from your AI chat, all offline.
Merge, split, extract, rotate, reorder and stamp PDF pages from your AI chat, all offline.
PDF and image tools for AI agents: compress, merge, split, OCR, sign. Runs locally, never uploads.
Split, merge and compress PDF files locally - private by design, no uploads.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to perform comprehensive PDF operations locally, including compression, text extraction, PII redaction, page organization, splitting, merging, watermarking, creation, and form filling, all without cloud uploads.22 npm-
- AlicenseBqualityBmaintenanceEnables AI agents to perform local-first PDF processing entirely on-device, including OCR write-back to make scans searchable, unlocking and re-encrypting PDFs, splitting/merging/rotating pages, and compressing files, with no cloud calls or file uploads.251MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to edit text inside real PDF files in place while preserving fonts and layout, with a before/after preview. Also supports compressing, merging, splitting, converting, translating, generating and querying PDFs through a hosted remote MCP endpoint.MIT
- AlicenseBqualityBmaintenanceLets AI assistants read, search, edit, annotate, sign, redact and OCR PDF files entirely on the local machine, with no uploads and non-destructive writes to new files. It also merges, splits and reorganises pages, fills forms, compares versions to detect tampering, and converts documents between PDF, Word, Excel, images and text, including turning bank statements into spreadsheet rows.22AGPL 3.0