Utilitly PDF — Claude Code MCP server: what it does, how to install
Utilitly PDF — an MCP server for local PDF work: merges, splits, rotates, deletes and reorders pages. Nothing gets uploaded.
MIT updated 2026-10-29
claude mcp add utilitly-pdf -- npx -y @utilitly/mcpWhat Utilitly PDF does
The server runs beside the AI and edits files in place. Eight tools: pdf_info reports page count, file size and password status; merge_pdfs combines multiple PDFs; split_pdf divides a file into parts by page ranges; extract_pages pulls selected pages into a separate document; rotate_pdf turns pages by multiples of 90 degrees; delete_pages removes pages; reorder_pages changes their order; duplicate_pages makes copies. Every result lands in a new file next to the original.
All operations happen on your machine, with no networking code anywhere in the server. The test test/network.test.ts blocks every route to the network, runs all eight tools, and they complete without opening a connection. The AI receives only the result paths, page counts and file sizes; PDF contents never enter the conversation.
Requires Node.js 22 or later. At install, you can list folders where the server may read and write — outside those, files are off-limits. Without a folder list, the server works with any file you can reach. Password-protected PDFs are refused; pdf_info tells you when a file is locked.
What it helps with
- combine multiple invoices into one PDF
- remove a blank page from a scanned document
- divide a handbook into three parts by page numbers
- turn several upside-down pages the right way
- check page count and password status
Example prompts for the agent
- Merge
~/Downloads/march.pdfand~/Downloads/april.pdf - Delete blank page 3 from
~/Desktop/scan.pdf
How to install Utilitly PDF
Platform CLI
claude mcp add utilitly-pdf -- npx -y @utilitly/mcpPlatform CLI
codex mcp add utilitly-pdf -- npx -y @utilitly/mcpConfig file
{
"mcpServers": {
"utilitly-pdf": {
"command": "npx",
"args": [
"-y",
"@utilitly/mcp"
]
}
}
}Config file
{
"servers": {
"utilitly-pdf": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@utilitly/mcp"
]
}
}
}Platform CLI
gemini mcp add utilitly-pdf npx -y @utilitly/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Utilitly PDF
How to install Utilitly PDF in Claude Code?
Run claude mcp add utilitly-pdf -- npx -y @utilitly/mcp. The first run downloads the server via npx.
What does Utilitly PDF do?
Merges, splits, rotates, deletes and reorders pages in PDFs. All operations are local, originals stay unchanged, results go to new files.
Do I need to list folders at install?
No, but without them the server can reach any file you can. Listing folders after the package name restricts the server to those folders only.