Quillpdf MCP server
io.github.PurpleDirective/quillpdf-mcp·v0.2.0·1 starsLocal-first PDF tools (merge, split, rotate, watermark, Bates, metadata) as MCP server + CLI.
1 stars33 downloads/wk
Reviews
Write oneNobody has reviewed Quillpdf yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Quillpdf tools (15, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
pdf_batesStamp sequential Bates numbers ({prefix}{zero-padded n}) on every page.
pdf_clean_metadataStrip document metadata: clears title, author, subject, keywords, creator and the CreationDate/ModDate
pdf_cropTrim the visible area of each page by the given margins, in points (72 = 1 inch).
pdf_delete_pageswrite actionRemove the listed pages, keeping everything else in its current order.
pdf_flattenPaint filled form values onto the page as static content. Afterwards the answers
pdf_from_imagesBuild a PDF from PNG and/or JPEG images, one image per page, in the order given.
pdf_mergeMerge two or more PDF files into one, in the order given.
pdf_organizeRebuild a PDF keeping only the pages you list, in the order you list them.
pdf_page_countReturn the number of pages in a PDF.
pdf_page_numbersStamp readable page numbers on each page. Distinct from Bates numbering:
pdf_protectEncrypt a PDF with AES-256 so it cannot be opened without the password.
pdf_rotateRotate pages by a multiple of 90 degrees. Omit `pages` to rotate every page.
pdf_splitSplit a PDF by 1-based page ranges (one output file per comma group, e.g. "1-3,5"),
pdf_unlockDecrypt a password-protected PDF you know the password for, so it opens without
pdf_watermarkStamp a text watermark on every page.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan15 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Quillpdf compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 89/100
- higher than 80% of 48,255 servers
- Tools
- 15
- the typical server has 7
- Tools that change things
- 7%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
- Downloads a week
- 33
- more than 22% of 12,191 servers with a package
What its tools let an agent do: 14 read · 1 change
Release history: 2 versions in the registry since 2026-07-14, latest 2026-09-25, typically one every 72 days.
Install Quillpdf in Claude Code, Cursor or VS Code
Runs npx -y quillpdf-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add quillpdf-mcp -- npx -y quillpdf-mcp
What the publisher says
From the Quillpdf repository's README, as published. We do not edit it. Read it on GitHub
quillpdf-mcp
PDF operations for MCP. An MCP server and CLI for local PDF manipulation:
- Merge, split, organize, delete pages
- Rotate, crop
- Watermark, Bates numbering, page numbers
- Flatten forms, images → PDF
- Metadata cleaning, page count
- AES-256 protect / unlock
Built on pdf-lib. MIT licensed. stdio transport. No network calls — files never leave your machine.
Install
npx -p quillpdf-mcp quillpdf --help # CLI
npx quillpdf-mcp --help # MCP server (your MCP client launches it over stdio)Or globally:
npm install -g quillpdf-mcp
quillpdf --helpRequires Node.js 18+.
Scope
quillpdf-mcp implements structural PDF transforms and AES-256 protect/unlock. It does not perform OCR, redaction, or compression — those are available in the browser version (quillpdf.com), where processing also stays client-side. They'll ship here only when they can run fully locally.
Use it from an AI assistant (MCP)
The MCP server speaks stdio and exposes one tool per operation.
Claude Desktop
Add to claudedesktopconfig.json:
{
"mcpServers": {
"quillpdf": {
"command": "npx",
"args": ["-y", "quillpdf-mcp"]
}
}
}Claude Code
claude mcp add quillpdf -- npx -y quillpdf-mcpThen ask your assistant things like "merge invoice-1.pdf and invoice-2.pdf into combined.pdf" or "Bates-number discovery.pdf with prefix ABC starting at 1." The assistant supplies file paths on your machine; the server reads and writes them locally.
A ready-to-copy config lives in examples/mcp-config.json.
Tools
Use it from the command line
# Merge (order is preserved)
quillpdf merge a.pdf b.pdf c.pdf -o combined.pdf
# Split into one file per range group → out-1.pdf (pages 1-3), out-2.pdf (page 5)
quillpdf split in.pdf --ranges "1-3,5" -o out.pdf
# Extract specific pages into a single file (reordering/duplicates allowed)
quillpdf split in.pdf --pages "5,1,1" -o extract.pdf
# Rotate every page 90°, or just some pages
quillpdf rotate in.pdf --angle 90 -o rotated.pdf
quillpdf rotate in.pdf --angle 180 --pages "2,4" -o rotated.pdf
# Watermark
quillpdf watermark in.pdf --text "DRAFT" --opacity 0.15 --position center -o wm.pdf
# Bates numbering → PLT-000001, PLT-000002, …
quillpdf bates in.pdf --prefix "PLT-" --start 1 --pad 6 -o numbered.pdf
# Strip document metadata
quillpdf clean-metadata in.pdf -o clean.pdf
# Page count (prints a number)
quillpdf page-count in.pdfEvery command has --help.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Quillpdf: common questions
- Is Quillpdf MCP server safe?
- Yes, by our scan: it is graded A (89/100). Read the Quillpdf safety report
- How do I install Quillpdf?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Quillpdf need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Quillpdf maintained?
- The last commit was 40 days ago (2026-09-25). The latest release is v0.2.0.
- How does Quillpdf compare with other MCP servers?
- safety score 89/100 (higher than 80% of 48,255 servers); tools 15 (the typical server has 7); tools that change things 7% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.