Skip to content
MCP server

superPDF AI

Local PDF tools for agents: read, convert, merge and split files without uploading them

Runs locallyStatus and history
Install
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/cli

Add to claude_desktop_config.json

{
  "mcpServers": {
    "superpdf": {
      "command": "npx",
      "args": [
        "-y",
        "@superpdf/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "superpdf": {
      "command": "npx",
      "args": [
        "-y",
        "@superpdf/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media