# Utilitly PDF

Utilitly PDF — an MCP server for local PDF work: merges, splits, rotates, deletes and reorders pages. Nothing gets uploaded.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: utilitlyPDF
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/utilitlyPDF/utilitly-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/utilitly-pdf

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add utilitly-pdf -- npx -y @utilitly/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add utilitly-pdf -- npx -y @utilitly/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "utilitly-pdf": {
            "command": "npx",
            "args": [
                "-y",
                "@utilitly/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "utilitly-pdf": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@utilitly/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add utilitly-pdf npx -y @utilitly/mcp
```

## When to use it
- 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
- Merge `~/Downloads/march.pdf` and `~/Downloads/april.pdf`
- Delete blank page 3 from `~/Desktop/scan.pdf`

## Similar
- [PDF Generator API](https://affpapa.org/en/nevibecode/mcp/pdf-generator-api.md) — MCP server · 346 installs
- [pdf-to-docx](https://affpapa.org/en/nevibecode/skills/pdf-to-docx.md) — skill · 6200 installs
- [PDF Form Filler](https://affpapa.org/en/nevibecode/skills/pdf-form-filler.md) — skill · 4900 installs
- [pandoc-pdf-generation](https://affpapa.org/en/nevibecode/skills/pandoc-pdf-generation.md) — skill · 553 installs
- [pdf-to-html](https://affpapa.org/en/nevibecode/skills/pdf-to-html.md) — skill · 529 installs
- [pdf-generation](https://affpapa.org/en/nevibecode/skills/pdf-generation.md) — skill · 491 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
