Skip to content
MCP server

Sezzlee PDF

Read PDFs from one sandboxed folder as Markdown, with page search and optional OCR

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.1.2
Listing updated
2 days ago

About Sezzlee PDF

Sezzlee PDF is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

This server reads, and only reads. Point it at a folder at startup and every PDF below it becomes available as page-numbered Markdown, with headings and tables kept as Markdown structure so an agent can read a revenue table by column. Nothing outside that folder is reachable: paths that climb out, absolute paths and symlinks leaving the root are refused, and error messages never reveal the folder's real location.

The usual sequence is three calls: list_documents to find a file, describe_document for page count, whether it is text or scanned and which pages lack readable text, then read_pages for just the pages needed. find_in_document does literal search and returns the page, line and surrounding text of each match. Pages with no text are flagged needsOcr instead of coming back blank.

OCR is off unless you pass a module with --ocr that supplies a rasterizer and a provider, so the connection decision stays with you; the server itself has no network code. It needs Node.js 22 or later on Apple-silicon macOS, glibc Linux or Windows x64, and does not run on Intel Macs or Alpine.

Install

Run in a terminal

claude mcp add pdf -- npx -y @sezzlee/pdf-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "pdf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sezzlee/pdf-mcp"
      ]
    }
  }
}

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

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

list_documents
List readable PDF candidates under the root
describe_document
Page count, document type and per-page OCR need
read_pages
Read selected pages as Markdown
find_in_document
Literal search over extracted text with page and context

What it does

Folder sandbox
Access is limited to one folder chosen at startup, including its subfolders.
Markdown pages
Pages come back numbered from 1 with tables kept as Markdown.
Document summary
describe_document reports page count, text or scanned, and pages that need OCR.
Literal search
find_in_document returns the page, line and context of each match.
Optional pluggable OCR
Scanned pages are read only when an OCR module is supplied with --ocr.
No network access
The server has no network code and no write tools.

Good for

  • Ask which region had the most revenue in an annual report
  • Search a folder of contracts for a clause by literal text
  • Check which pages of a scan need OCR
  • Pull one table out of a long report without loading the whole file

Pricing

Open source

Free; part of the MIT-licensed Sezzlee MCP repository

Prices change. Check docs.sezzlee.app before you buy.

Sezzlee PDF FAQ

Can it change my PDFs?

No. It has no write tools, so documents are never modified.

How do I limit what it can see?

Pass one absolute folder path as the only argument; everything outside is refused.

Does it do OCR?

Only if you start it with --ocr and a module that supplies a rasterizer and an OCR provider.

Where does it run?

On Apple-silicon macOS, glibc Linux and Windows x64 with Node.js 22 or later.

Is Sezzlee PDF free?

Yes. Sezzlee PDF is open source, so you can use and self-host it for free.

How do I add Sezzlee PDF to Claude Code?

Run this command in your terminal: claude mcp add pdf -- npx -y @sezzlee/pdf-mcp

What are the best alternatives to Sezzlee PDF?

The closest alternatives to Sezzlee PDF are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to Sezzlee PDF

  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