superPDF AI
Local PDF tools for agents: read, convert, merge and split files without uploading them
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.4.1
- Listing updated
- 2 days ago
About superPDF AI
superPDF AI is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Setup starts with an npm install of the @superpdf/cli package, which needs Node.js 22 or later, then pointing your agent at superpdf mcp --allow-dir with a folder you create. The agent can only touch files inside that folder, and the server refuses to start if the folder does not exist.
Processing happens on your machine and nothing is uploaded. The README explains that the reader works from the text, fonts and drawings inside a PDF rather than a language model, rebuilding headings, tables and charts as Markdown, HTML or JSON, and sends scans through Tesseract OCR. One caveat the docs give: when the agent reads document text, that text goes to the agent's own model.
The same engine also ships as a command line tool, a Python and JavaScript SDK, a local REST API, and loaders for LangChain and LlamaIndex. The author reports a score of 65.0 on the ParseBench suite from its own run and notes it is not on the official leaderboard.
Install
Run in a terminal
claude mcp add superpdf -- npx -y @superpdf/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"superpdf": {
"command": "npx",
"args": [
"-y",
"@superpdf/cli"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"superpdf": {
"command": "npx",
"args": [
"-y",
"@superpdf/cli"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"superpdf": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@superpdf/cli"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"superpdf": {
"command": "npx",
"args": [
"-y",
"@superpdf/cli"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"superpdf": {
"command": "npx",
"args": [
"-y",
"@superpdf/cli"
]
}
}
}Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- pdf_list_files
- List PDFs in an allowed folder
- pdf_info
- Page count, sizes, form fields and properties
- pdf_read_text
- Embedded text by page, with a character limit
- pdf_extract_structure
- Markdown, HTML or JSON with headings, paragraphs and a section outline
- pdf_merge
- Combine two or more PDFs into a new file
- pdf_split
- One new file per range or per page
- pdf_from_office
- Convert Word, Excel, PowerPoint or OpenDocument files to PDF
What it does
- Folder-restricted access
- Agents can only open PDFs inside the directory you pass with --allow-dir.
- Structure extraction
- Output as Markdown, HTML or JSON with headings, paragraphs and a section outline.
- Merge and split
- Combine PDFs into one file or write one file per page or range.
- Office to PDF
- Word, Excel, PowerPoint and OpenDocument files convert to PDF.
- OCR for scans
- Scanned pages are read with Tesseract OCR.
- Many client configs
- Documented setup for Claude Code, Claude Desktop, Codex and Cursor.
Good for
- Turn a report with tables and charts into Markdown for an agent
- Split a long PDF into single pages and number them
- Merge several PDFs into one deliverable
- Fill or compare PDF forms from an assistant
- Convert Office documents to PDF without uploading them
Pricing
Open source
Runs locally; the project's README lists a licence file
Prices change. Check superpdf.ai before you buy.
superPDF AI FAQ
Are my files uploaded?
No. superPDF runs on your computer and uploads nothing, though text your agent reads is passed to its model.
What do I need to install it?
Node.js 22 or later and the npm package @superpdf/cli.
Does it use a language model to read PDFs?
The README says the reader works by rules, not a language model, and uses Tesseract for scans.
How do I limit what the agent can see?
Start the server with --allow-dir pointing at a folder you chose.
Is superPDF AI free?
Yes. superPDF AI is open source, so you can use and self-host it for free.
How do I add superPDF AI to Claude Code?
Run this command in your terminal: claude mcp add superpdf -- npx -y @superpdf/cli
What are the best alternatives to superPDF AI?
The closest alternatives to superPDF AI are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.
Alternatives to superPDF AI

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents
Invoices
MCP serverMCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files
- 4 tools
- Remote
- Paid
- Files and documents

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media

WhoScribe
MCP serverSearch and read your WhoScribe audio and video transcripts from ChatGPT, read-only
Not checked yet- Remote
- Freemium
- Design and media