PDFluent
Read, search and fill local PDFs as markdown, text, tables or form fields, offline
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"pdfluent-mcp": {
"command": "uvx",
"args": [
"pdfluent-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pdfluent-mcp": {
"command": "uvx",
"args": [
"pdfluent-mcp"
]
}
}
}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

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