Skip to content
MCP server

Pdf MCP

Local MCP server to search and read one PDF or a folder of them, with page citations

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
3.8.0
Listing updated
today

Similar MCP servers

About Pdf MCP

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

pdf-mcp is built for documents too long to paste into a chat. The agent calls pdf_info to see page count and table of contents, pdf_search to locate content, and pdf_read_pages to read only the pages it needs. Search is hybrid, BM25 keyword plus semantic, and hits come with the page they came from.

The README lists 13 tools, including table extraction, rendering pages as PNG for vision models so text can be checked against what is printed, chart data as (x, y) tables, and OCR for scanned pages through Tesseract. For folders, corpus tools warm, triage and search many PDFs at once, backed by an SQLite cache that persists across restarts. Text returned is treated as untrusted, and hidden text, including injected instructions, is flagged rather than silently passed on.

It runs over stdio, installs from PyPI or as a Claude Desktop .mcpb extension, and is MIT licensed. Reading order handles multi-column and Japanese vertical layouts.

Install

Run in a terminal

claude mcp add pdf-mcp -- uvx pdf-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": [
        "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-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pdf-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": [
        "pdf-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "pdf-mcp": {
      "command": "uvx",
      "args": [
        "pdf-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PDF_MCP_CACHE_DIRDirectory for storing PDF cache (default: ~/.cache/pdf-mcp)
  • PDF_MCP_CACHE_TTLOptional time expiry in hours; unset keeps a document while its PDF exists
  • PDF_MCP_CACHE_MAX_MBCache size cap in MB, least recently used evicted first (default: 2048; 0 = no cap)

Tools this server provides (13)

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

pdf_info
Page count, metadata, TOC summary, scanned-page detection
pdf_search
Hybrid keyword and semantic search by page or section
pdf_read_pages
Read specific pages or ranges with OCR, tables and images
pdf_read_all
Read a whole document in one call, byte-capped
pdf_get_toc
Full table of contents
pdf_render_pages
Render pages as PNG for vision models
pdf_extract_chart
Chart data as exact (x, y) tables
pdf_corpus_warm
Warm a folder of PDFs into the cache
pdf_corpus_overview
Per-document triage cards for a folder
pdf_corpus_search
Search across a folder
pdf_cache_stats
Per-document cache breakdown and total size
pdf_cache_clear
Clear expired or all cache entries
server_info
Which optional features and config are active

What it does

Selective page reading
Read specific pages or ranges instead of loading the whole document.
Hybrid search
Keyword and semantic search with page and section provenance.
Folder corpus tools
Warm, triage and search a whole folder of PDFs.
OCR for scans
Tesseract OCR on scanned pages, run in parallel.
Tables and charts
Structured table rows and chart data as (x, y) values.
Hidden-text flagging
Reports text a reader cannot see so injected instructions are not passed on silently.

Good for

  • Summarise risk factors from a 200-page annual report
  • Search a folder of papers for one topic
  • Extract a table from a PDF
  • OCR a scanned document
  • Check extracted text against a rendered page

Pricing

Open source

MIT licence; free

Pdf MCP FAQ

What does the cache do?

An SQLite cache avoids re-parsing PDFs and survives restarts; its size cap defaults to 2048 MB.

How big is the first install?

The Claude Desktop extension downloads about 250 MB of components on first start.

Do scanned PDFs work?

Yes, through Tesseract OCR; the extension downloads a small English-only version on first use.

Which Python versions?

Python 3.11 to 3.14.

What licence?

MIT.

Is Pdf MCP free?

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

How do I add Pdf MCP to Claude Code?

Run this command in your terminal: claude mcp add pdf-mcp -- uvx pdf-mcp

What are the best alternatives to Pdf MCP?

The closest alternatives to Pdf MCP are SSRS2, Csv, Google_sheets, Onedrive and Zovo Spreadsheet Compare.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers