pdf-filler-recursive-simple-mcp
Provides PDF analysis, data extraction, form filling, and comparison capabilities for Claude and Cursor, supporting both text and scanned documents with OCR.
README
PDF Tools - Analyze, Extract, Fill, Compare
A comprehensive PDF toolkit for Claude that enables document analysis, data extraction, form filling, and comparison. Works with both Claude Desktop (as an extension) and Cursor (as an MCP server).
🎯 Choose Your Platform
🖥️ Claude Desktop Extension
Perfect for dedicated Claude Desktop users who want PDF filling built-in.
⚡ Cursor MCP Server
Perfect for developers who want PDF filling while coding in Cursor.
Features
Core Features
- 📖 Analyze Documents - Extract and analyze full PDF content (300+ pages)
- 📊 Extract Data - Pull tables, text, and structured data from any PDF
- 🔍 Compare Contracts - Identify changes between document versions
- ✏️ Fill Forms - Automate form completion (W-9, 1099, I-9, etc.)
- 📋 List & Organize - Browse and manage PDF collections
- 🔐 Password Support - Handle encrypted and protected PDFs
- 👁️ OCR Support - Extract text from scanned documents
Advanced Features
- 📊 Bulk Fill from CSV - Fill multiple PDFs using data from spreadsheets
- 👤 Profile System - Save and reuse common form data
- 📤 Extract to CSV - Export data from filled PDFs to spreadsheets
- ✅ Form Validation - Check for missing required fields
- 🚀 Easy Sharing - Share with friends via simple installer package
Installation
🖥️ For Claude Desktop
Quick Install
- Download the latest .mcpb file from Releases
- Double-click the
.mcpbfile to install in Claude Desktop
Or manually:
- Open Claude Desktop
- Go to Settings → Developer → Edit Config
- The
.mcpbfile will auto-configure itself when opened
NOTE: The extension is also available in the Claude Extensions directory. If installing from there doesn't work with your Claude Desktop version, use the .mcpb file from our releases instead.
Build from Source
git clone https://github.com/silverstein/pdf-filler-recursive-simple-mcp
cd pdf-filler-recursive-simple-mcp
npm install
npm install -g @anthropic-ai/mcpb
mcpb pack
# Install the generated .mcpb file in Claude Desktop
⚡ For Cursor
📦 Easy Install
- Download pdf-filler-mcp.zip from Releases
- Unzip the file anywhere
- Mac users: Double-click
install.command - All users: Or run
./smart-install.shin Terminal - Restart Cursor - Look for "pdf-filler" with "11 tools enabled"
🛠️ Developer Install
git clone https://github.com/silverstein/pdf-filler-recursive-simple-mcp
cd pdf-filler-recursive-simple-mcp
npm install
# Add to your ~/.cursor/mcp.json:
{
"mcpServers": {
"pdf-filler": {
"command": "node",
"args": ["/full/path/to/pdf-filler-simple/server/index.js"]
}
}
}
# Restart Cursor
Usage
Works the same way in both Claude Desktop and Cursor! Ask Claude to:
List PDFs
"List all PDFs in my Documents folder" "Show me PDF files in /Users/myname/Downloads"
Read PDF Form Fields
"What form fields are in this PDF file?" "Read the form fields from application.pdf on my Desktop"
Fill PDF Forms
"Fill this W-9 PDF with my business information" "Fill the PDF at /path/to/form.pdf with John Doe as the name and save it to filled-form.pdf"
Bulk Fill from CSV
"Fill the template.pdf with data from employees.csv and save all PDFs to /Users/me/filled-forms/" "Use the 'employee_name' column for filenames"
Save and Use Profiles
"Save this as my 'work' profile: name John Doe, title Software Engineer, company Tech Corp" "Fill application.pdf using my work profile and save to filled-app.pdf"
Extract Data to Spreadsheet
"Extract all data from these PDFs to summary.csv"
Validate Forms
"Validate if all required fields are filled in application.pdf"
Read PDF Content (NEW! v0.3.0)
"Read the content of this PDF: /path/to/document.pdf" "Convert this PDF to markdown format" "Extract all text from my estate planning PDF" "Summarize the main points in this contract PDF" "What does this PDF say about payment terms?" "Analyze this scanned invoice PDF" (automatically uses OCR)
Note: The read_pdf_content tool automatically handles both text-based and scanned PDFs
Sharing with Friends
🎁 Create Shareable Cursor Package
# For Cursor users - creates easy installer
node package-for-friend.js
# Share the generated pdf-filler-mcp.zip
🖥️ Share Claude Desktop Extension
# For Claude Desktop users
dxt pack
# Share the generated .dxt file
🚀 What Your Friends Get
Cursor Users:
- Double-click installer (Mac)
- Smart terminal installer (all platforms)
- Auto-detects paths - no manual configuration
- Safe installation - moves files to permanent location
Claude Desktop Users:
- Simple .dxt file install
- Built-in extension experience
How It Works
This solution uses:
- MCP (Model Context Protocol) for both Claude Desktop and Cursor integration
- pdf-lib for PDF manipulation
- Node.js for the server runtime
Development
Project Structure
pdf-filler-recursive-simple-mcp/
├── server/index.js # MCP server (works for both!)
├── package.json # Node.js dependencies
├── manifest.json # Claude Desktop extension metadata
├── pdf-toolkit.dxt # Claude Desktop extension package
├── pdf-filler-mcp-share/ # Cursor shareable package
├── pdf-filler-mcp.zip # Cursor ready-to-share installer
└── README.md # This file
Available Tools
Same 11 tools work in both Claude Desktop and Cursor:
- list_pdfs - Lists all PDF files in a specified directory
- read_pdf_fields - Extracts form field information from a PDF (supports password parameter)
- fill_pdf - Fills a PDF form with provided data (supports password parameter)
- bulk_fill_from_csv - Fill multiple PDFs using CSV data (supports password parameter)
- save_profile - Save form data as a reusable profile
- load_profile - Load a saved profile
- list_profiles - List all saved profiles
- fill_with_profile - Fill a PDF using a saved profile (supports password parameter)
- extract_to_csv - Extract data from PDFs to CSV
- validate_pdf - Check for missing required fields (supports password parameter)
- read_pdf_content - Read and analyze full PDF content - extract text, summarize, convert formats, answer questions
Requirements
For Claude Desktop:
- Claude Desktop (with developer mode enabled)
- Node.js 18+ (for building from source)
For Cursor:
- Cursor with MCP support
- Node.js 18+
Both support: macOS, Windows, Linux
Examples
W-9 Tax Form
"Fill this W-9 with my business info: Company Name LLC, 123 Main St, Tax ID 12-3456789"
Job Applications
"Use my 'personal' profile to fill this job application PDF"
Bulk Processing
"Fill 50 contract PDFs using the client data from contracts.csv"
Password-Protected PDFs
"Read the fields from this encrypted PDF using password 'mypassword123'" "Fill this protected PDF with my data, the password is 'secure456'"
License
MIT
Contributing
Pull requests welcome! This project supports both Claude Desktop extensions and Cursor MCP servers.
🎉 Best of both worlds - use with Claude Desktop OR Cursor!
Perfect for W-9s, contracts, job applications, and any repetitive PDF form filling! 📄✨
推荐服务器
Baidu Map
百度地图核心API现已全面兼容MCP协议,是国内首家兼容MCP协议的地图服务商。
Playwright MCP Server
一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。
Magic Component Platform (MCP)
一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。
Audiense Insights MCP Server
通过模型上下文协议启用与 Audiense Insights 账户的交互,从而促进营销洞察和受众数据的提取和分析,包括人口统计信息、行为和影响者互动。
VeyraX
一个单一的 MCP 工具,连接你所有喜爱的工具:Gmail、日历以及其他 40 多个工具。
graphlit-mcp-server
模型上下文协议 (MCP) 服务器实现了 MCP 客户端与 Graphlit 服务之间的集成。 除了网络爬取之外,还可以将任何内容(从 Slack 到 Gmail 再到播客订阅源)导入到 Graphlit 项目中,然后从 MCP 客户端检索相关内容。
Kagi MCP Server
一个 MCP 服务器,集成了 Kagi 搜索功能和 Claude AI,使 Claude 能够在回答需要最新信息的问题时执行实时网络搜索。
e2b-mcp-server
使用 MCP 通过 e2b 运行代码。
Neon MCP Server
用于与 Neon 管理 API 和数据库交互的 MCP 服务器
Exa MCP Server
模型上下文协议(MCP)服务器允许像 Claude 这样的 AI 助手使用 Exa AI 搜索 API 进行网络搜索。这种设置允许 AI 模型以安全和受控的方式获取实时的网络信息。