Sohaib-2/pdf-mcp-server

> Transform PDF manipulation with AI-powered natural language commands through Claude integration
Comprehensive PDF toolkit that integrates seamlessly with Claude AI via MCP (Model Context Protocol). Perform complex PDF operations using simple conversational commands - merge, split, encrypt, optimize, and analyze PDFs effortlessly.
🚀 Quick Start
Clone & Setup
Option 1: With Virtual Environment (Recommended)
Option 2: Without Virtual Environment
Install PDF Tools
**PDFtk:**
**QPDF:**
🔧 Claude Desktop Integration
1. **Locate Claude config file:**
- **Windows:** %APPDATA%\Claude\claude_desktop_config.json
- **macOS:** ~/Library/Application Support/Claude/claude_desktop_config.json
2. **Add PDF MCP Server:**
**With Virtual Environment:**
**Without Virtual Environment:**
**macOS/Linux with venv:**
3. **Restart Claude Desktop**
4. **Start using natural language:**
- *"Merge these 3 PDFs into one document"*
- *"Encrypt my report with password protection"*
- *"Extract pages 1-10 from this manual"*
📚 Complete Tool Reference
Core Operations
| Tool | Description | Example |
|------|-------------|---------|
| merge_pdfs | Combine multiple PDFs | merge_pdfs(['doc1.pdf', 'doc2.pdf'], 'combined.pdf') |
| split_pdf | Split into individual pages | split_pdf('document.pdf', './pages/') |
| extract_pages | Extract specific page ranges | extract_pages('book.pdf', '1-5,10,15-20', 'excerpt.pdf') |
| rotate_pages | Rotate pages by degrees | rotate_pages('scan.pdf', '90', 'rotated.pdf', '1-3') |
Security & Encryption
| Tool | Description | Example |
|------|-------------|---------|
| encrypt_pdf | AES-256 encryption | encrypt_pdf('file.pdf', 'secure.pdf', 'password123') |
| encrypt_pdf_basic | Basic password protection | encrypt_pdf_basic('doc.pdf', 'protected.pdf', 'pass', 'admin') |
| decrypt_pdf | Remove password protection | decrypt_pdf('locked.pdf', 'unlocked.pdf', 'password') |
Optimization & Repair
| Tool | Description | Example |
|------|-------------|---------|
| optimize_pdf | Compress for web/email | optimize_pdf('large.pdf', 'small.pdf', 'high') |
| repair_pdf | Fix corrupted PDFs | repair_pdf('broken.pdf', 'fixed.pdf') |
| check_pdf_integrity | Validate PDF structure | check_pdf_integrity('suspicious.pdf') |
Information & Analysis
| Tool | Description | Example |
|------|-------------|---------|
| get_pdf_info | Detailed metadata (JSON) | get_pdf_info('document.pdf') |
| update_pdf_metadata | Modify title/author/etc | update_pdf_metadata('file.pdf', 'updated.pdf', title='New Title') |
| inspect_pdf_structure | Internal structure analysis | inspect_pdf_structure('complex.pdf', detailed=True) |
| extract_pdf_attachments | Extract embedded files | extract_pdf_attachments('portfolio.pdf', './attachments/') |
File Management
| Tool | Description | Example |
|------|-------------|---------|
| download_pdf | Download from URL | download_pdf('https://example.com/file.pdf', 'local.pdf') |
| open_pdf_preview | Open with system viewer | open_pdf_preview('report.pdf', browser=False) |
| get_file_info | File size/path details | get_file_info('document.pdf') |
| configure_pdf_workspace | Set working directory | configure_pdf_workspace('/path/to/workspace') |