PDF Toolkit MCP server

by AryanBV·io.github.AryanBV/pdf-toolkit-mcp·v0.3.1·9 stars

No reviews yet

Write-capable PDF toolkit MCP: 22 tools to read, create, render, encrypt, merge & fill PDFs.

A88/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A88/100

full report

Adoption

Growing

9 stars191 downloads/wk

Reviews

Write one

Nobody has reviewed PDF Toolkit yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

PDF Toolkit tools (22, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

pdf_add_page_numbers
Add page numbers to a PDF. Supports configurable position, format, starting number, and font size.
pdf_add_watermark
Add a text watermark to PDF pages. Watermark is centered and rotated diagonally by default. Applies to all pages if no page range is specified.
pdf_compare
Compare two PDFs page by page (by absolute page index) and report text differences. Returns identical:true when text matches. Diffs content-stream-order text (not visual reading order), so it is best for same-layout documents; reflowed or multi-column PDFs produce noisy diffs. Inserting/deleting a page shifts all later pages and reports them as changed. Large diffs are trimmed (truncated:true) to
pdf_createwrite action
Create a new PDF from text content with automatic line wrapping and page overflow. Supports A4, Letter, and Legal page sizes. Provide fontPath for non-Latin text (Arabic, CJK, etc.).
pdf_create_from_markdownwrite action
Create a rich, high-fidelity PDF from Markdown (CommonMark + GFM). Supports headings, bold/italic, links, ordered/bullet lists, tables, fenced code blocks, blockquotes, and horizontal rules.
pdf_create_from_templatewrite action
Create a polished PDF from a named template (invoice, report, or letter). Pass structured data matching the template's fields; data is validated against the template's schema.
pdf_delete_pageswrite action
Delete specific pages from a PDF, keeping the rest in their original order. AcroForm fields on the remaining pages are preserved. Set flatten:true to bake field values into static content. Cannot delete every page.
pdf_embed_image
Embed a PNG or JPEG image into a specific page of a PDF. Supports custom positioning and optional scaling with aspect ratio preservation.
pdf_embed_qr_code
Embed a QR code or barcode into a specific page of a PDF at given coordinates. Supports qrcode, code128, datamatrix, ean13, pdf417, and azteccode.
pdf_encrypt
Encrypt a PDF with AES-256 password protection. Requires a user password to open. Owner password controls editing permissions (defaults to the user password).
pdf_extract_text
Extract text content from a PDF file. Returns first 10 pages by default to avoid exceeding LLM context limits. Use the 'pages' parameter for specific pages.
pdf_fill_form
Fill form fields in a PDF. Supports text, checkbox, dropdown, radio, and list-box (multi-select) fields. Provide fontPath for non-Latin text (Arabic, CJK, etc.).
pdf_flatten
Flatten a PDF's form fields, baking their current values into the page content and removing interactivity. Form-less PDFs are copied unchanged.
pdf_get_form_fields
List all form fields in a PDF with their names, types, current values, and required status. Returns hasForm: false for PDFs without forms.
pdf_get_metadata
Get metadata from a PDF file including title, author, subject, page count, creation/modification dates, and producer information.
pdf_merge
Merge multiple PDF files into one. AcroForm fields are preserved; fields whose names collide across inputs are auto-renamed (namespaced by source). Set flatten:true to bake field values into static content.
pdf_render_pages
Render PDF pages to images so a vision-capable client can read scanned or image-only PDFs. Writes PNG/JPEG files and returns their paths; set inline:true to return image blocks the model can see directly.
pdf_reorder_pages
Reorder pages in a PDF. Specify the new page order as a comma-separated string (e.g. '3,1,2'). Duplicates are allowed. AcroForm fields are preserved. Set flatten:true to bake field values into static content.
pdf_rotate_pages
Rotate pages in a PDF by 90, 180, or 270 degrees. Rotation is additive to any existing rotation. Rotates all pages if no page range is specified.
pdf_search
Search text across a PDF and return matches with a short surrounding snippet and the page number. The query is matched as a literal substring (case-insensitive by default). Searches all pages unless a range is given.
pdf_split
Extract specific pages from a PDF into a new file. AcroForm fields on the extracted pages are preserved; fields on omitted pages are dropped. Set flatten:true to bake field values into static content.
pdf_to_markdown
Convert a PDF to clean, reading-order Markdown for LLM consumption: reconstructs up to 2 content columns (plus full-width title/footer bands), infers headings from font size, and detects bullet/numbered lists. Pages with 3 or more columns fall back to single-column reading order. Tables are emitted as plain reading-order text, NOT reconstructed as Markdown tables. Best on clean, digital (text-base

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan51 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 67 days ago12/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How PDF Toolkit compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 88/100; higher than 75% of 48,255 servers
Tools: 22; the typical server has 7
Tools that change things: 18%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 9; more than 87% of 28,688 servers
Downloads a week: 191; more than 74% of 12,191 servers with a package

What its tools let an agent do: 18 read · 4 change

Install PDF Toolkit in Claude Code, Cursor or VS Code

Runs npx -y @aryanbv/pdf-toolkit-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add pdf-toolkit-mcp -- npx -y @aryanbv/pdf-toolkit-mcp

Add to Cursor

What the publisher says

From the PDF Toolkit repository's README, as published. We do not edit it. Read it on GitHub

PDF Toolkit MCP

💼 Available for freelance MCP/AI integration work — DM @aryansalian03 or via aryanbv.com

A write-capable PDF toolkit for any MCP client. It provides 22 tools for reading, creating, rendering, transforming, and securing PDFs. That includes rendering pages to images so vision models can read scanned documents, building PDFs from Markdown or structured data, AES-256 encryption, and merge and split operations that keep form fields intact. There are no native dependencies, so it runs locally from a single npx command.

npx -y @aryanbv/pdf-toolkit-mcp

It needs no config files, API keys, Docker, or compiler, and it works offline.

Overview

Most PDF servers for MCP only read. This one also writes: it creates documents from Markdown or structured data, fills and flattens forms, rearranges page structure, and applies AES-256 encryption, all without a native build toolchain.

A few things worth knowing:

It reads scans. pdfrenderpages rasterizes pages to images, so a vision-capable model can read scanned or image-only PDFs that have no text layer.
Merge, split, reorder, and delete preserve AcroForm fields rather than dropping them. Names that collide between inputs are namespaced per source, and every call reports what it preserved, renamed, or dropped.
Encryption is AES-256 through qpdf, not the legacy RC4 scheme.
Every engine is WASM or plain JavaScript, so npx works on Node 20 and later across Windows, macOS, and Linux with no node-gyp, canvas binding, or prebuilt binary.
Errors carry stable codes, stack traces stay internal, off-page placements are rejected instead of silently clipped, and large responses are truncated without breaking JSON.

Client setup

Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

Claude Code

claude mcp add pdf-toolkit -- npx -y @aryanbv/pdf-toolkit-mcp

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

VS Code (GitHub Copilot)

VS Code uses "servers", not "mcpServers". Copying another client's config will fail silently. This also requires the GitHub Copilot extension with Agent mode.

Add to .vscode/mcp.json:

{
  "servers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pdf-toolkit": {
      "command": "npx",
      "args": ["-y", "@aryanbv/pdf-toolkit-mcp"]
    }
  }
}

Once connected, ask for what you want in plain language and the client selects the tool and fills in the arguments. The JSON blocks below show the arguments each tool accepts, for reference.

Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

PDF Toolkit: common questions

Is PDF Toolkit MCP server safe?: Yes, by our scan: it is graded A (88/100). Read the PDF Toolkit safety report
How do I install PDF Toolkit?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does PDF Toolkit need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is PDF Toolkit maintained?: The last commit was 105 days ago (2026-07-22). The latest release is v0.3.1.
What can I use instead of PDF Toolkit?: Servers from other publishers that do the same job: kordoc MCP server.
How does PDF Toolkit compare with other MCP servers?: safety score 88/100 (higher than 75% of 48,255 servers); tools 22 (the typical server has 7); tools that change things 18% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to PDF Toolkit

Same job from other publishers: the closest match first, then the best rated.

kordoc
Parse Korean documents (HWP, HWPX, PDF, XLSX, DOCX, PPTX) to Markdown; fill forms, diff, render.
not reviewed
Widely used
A