Skip to content
MCP server

PDFluent

Read, search and fill local PDFs as markdown, text, tables or form fields, offline

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.3.0
Listing updated
3 days ago

About PDFluent

PDFluent is a free MCP server for files and documents. It runs locally on your machine and is started by your AI client.

This server runs over stdio from the pdfluent Python package, one process per client, and only reads or writes within directories you allow. Documents are not uploaded. A setup command registers it in Claude Desktop, Claude Code, Cursor and Codex, and it needs Python 3.10 or later and uv. A balanced quality tier needs model files, installed once.

Nine tools cover extracting markdown in reading order, page-by-page text, tables, positioned blocks with bounding boxes, metadata (including encryption, signatures and pages lacking a text layer), searching for a phrase, listing form fields and filling them into a new file without touching the original. A vision_advice tool flags pages that need a vision model. Page numbers are 0-based.

Limits are set by environment variables for pages per call, file size and output length. It comes from PDFluent, whose Rust SDK is free under AGPL-3.0 and whose desktop editor is free.

Install

Run in a terminal

claude mcp add pdfluent-mcp -- uvx pdfluent-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdfluent-mcp": {
      "command": "uvx",
      "args": [
        "pdfluent-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pdfluent-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pdfluent-mcp"
      ]
    }
  }
}

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

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

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

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

Configuration

  • PDFLUENT_MCP_MAX_PAGESPages one call may read (default 200).
  • PDFLUENT_MCP_MAX_BYTESLargest document the server opens, in bytes (default 104857600).
  • PDFLUENT_MCP_MAX_OUTPUT_CHARSLongest result one call returns, in characters (default 200000).

Tools this server provides (9)

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

extract_markdown
Document as markdown in reading order.
extract_text
Plain text layer, page by page.
extract_tables
Tables with rows and header rows.
extract_blocks
Positioned blocks with bounding boxes and confidence.
get_metadata
Page count, title, author, dates, encryption, signatures and bookmarks.
search
Pages mentioning a query, with snippets.
list_form_fields
Every form field with name, type, value and page.
fill_form
Fill named fields into a new file.
vision_advice
Per-page hint on whether a vision model is needed.

What it does

Markdown extraction
Returns reading-order markdown with headings and tables.
Tables and blocks
Extracts tables and positioned blocks with confidence.
Search
Finds pages mentioning a query with snippets.
Form filling
Fills fields and writes a new file.
Local only
Runs on your machine and reads only allowed folders.
Vision hints
Flags pages that need a vision model.

Good for

  • Summarise a long report PDF
  • Pull tables out of an invoice
  • Fill an application form
  • Find which pages mention a policy term

Pricing

Free

Free; PDFluent SDK is AGPL-3.0 with a commercial licence option

Prices change. Check pdfluent.com before you buy.

PDFluent FAQ

Are my PDFs uploaded?

No. The server runs locally and documents stay on your machine.

Does fill_form overwrite the input?

No. It writes a new file.

What does it need?

Python 3.10 or later and uv.

Are page numbers 1-based?

No. They are 0-based.

Is PDFluent free?

Yes. PDFluent is free to use.

How do I add PDFluent to Claude Code?

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

What are the best alternatives to PDFluent?

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

Alternatives to PDFluent

  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