# PDFluent

> PDFluent is a free MCP server for files and documents. Read, search and fill local PDFs as markdown, text, tables or form fields, offline. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://pdfluent.com
- **Repository:** https://github.com/pdfluent/pdfluent-mcp
- **MCP Registry name:** io.github.pdfluent/pdfluent-mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdfluent-mcp -- uvx pdfluent-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/pdfluent
