1pdf MCP Server

The best 96 PDF tools for Claude, Cursor & Codex.

Give your AI assistant the power to merge, split, compress, convert, encrypt, OCR, and summarize PDFs — all with natural language.

Quick Start

Claude Code

claude mcp add 1pdf -- npx -y onepdf-mcp-server

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "1pdf": {
      "command": "npx",
      "args": ["-y", "onepdf-mcp-server"]
    }
  }
}

Cursor

Settings → MCP → Add Server:

Command: npx
Args: -y, onepdf-mcp-server

Windsurf

Settings → MCP → Add Server:

npx -y onepdf-mcp-server

What You Can Do

Once installed, just talk to your AI assistant naturally:

"Merge report1.pdf and report2.pdf"
"Split this PDF into pages 1-3 and 5"
"Encrypt this PDF with password mypass123"
"Add a DRAFT watermark to this PDF"
"Add page numbers to this PDF"

Available Tools (v0.1.0)

Tool	Description	Cost
merge_pdfs	Combine multiple PDFs into one	Free
split_pdf	Extract specific pages by range	Free
encrypt_pdf	Add password protection	Free
decrypt_pdf	Remove password from protected PDF	Free
rotate_pdf	Rotate pages by 90°, 180°, or 270°	Free
delete_pages	Remove specific pages	Free
sort_pages	Reorder pages in custom order	Free
compress_pdf	Reduce file size	Free
add_watermark	Add text watermark to all pages	Free
add_page_numbers	Add customizable page numbers	Free

All 10 tools run locally — your files never leave your machine.

Coming Soon (v1.0 - Cloud)

86 more tools including:

• 🔄 Convert: Word↔PDF, Image↔PDF, 20+ formats
• ✏️ Edit: Signatures, forms, crops, stamps
• 🔍 OCR: Text recognition for scanned documents
• 🤖 AI: Summarize, extract info, chat with PDF
• ⚡ Optimize: Repair, linearize, flatten
• 🔒 Security: Sanitize, permissions, metadata

Requirements

• Node.js 18+
• Claude Desktop, Cursor, Windsurf, or Claude Code

Development

git clone https://github.com/1pdf/mcp-server.git
cd mcp-server
npm install
npm test

License

MIT © 1pdf