12 tools
Organize
Merge, split, reorder, rotate, extract and remove pages.
npm v0.3.0 · MIT · Node.js 18+
Your AI understands the task. Give it 91 PDF tools to finish it.
1PDF MCP gives Codex, Claude, Cursor and other Agents reliable PDF execution through natural language. Install once, then merge, convert, secure and analyze files without asking your Agent to improvise a script.
Install for Codex
stdiocodex mcp add 1pdf -- npx -y onepdf-mcp-serverThen open Codex and ask: “Merge these contracts, remove blank pages and add page numbers.”
One server, broad coverage
From one-off edits to multi-step workflows
Agents handle intent and sequencing. 1PDF performs the file operations and returns structured, truthful results.
24 tools
Convert
Move between PDF, images, Office, Markdown, email and ebook formats.
15 tools
Edit & secure
Watermark, number, crop, encrypt, sanitize, sign and fill forms.
40 tools
Analyze & specialize
Read, compare, extract tables and images, rasterize and automate layouts.
Works with your MCP client
Codex
CLI, desktop app and IDE extension share the same MCP configuration.
Claude
One command for Claude Code, or a small JSON block for Claude Desktop.
Cursor
Add the npm command as a local stdio server in MCP settings.
Other MCP clients
Use any client that can launch a local stdio server with npx.
Install
Add 1PDF to the Agent you already use
No account or API key is required for the core MCP tools.
Codex
Official setup docsRun this once in your terminal. The CLI, desktop app and IDE extension share the configuration.
codex mcp add 1pdf -- npx -y onepdf-mcp-serverClaude Code
Official setup docsAdd the local stdio server at project scope, then check it with claude mcp list.
claude mcp add 1pdf -- npx -y onepdf-mcp-serverClaude Desktop and Cursor
In Claude Desktop, add this block to claude_desktop_config.json. In Cursor, open Settings → MCP → Add Server and use npx as the command with -y, onepdf-mcp-server as arguments.
{
"mcpServers": {
"1pdf": {
"command": "npx",
"args": ["-y", "onepdf-mcp-server"]
}
}
}system_status
Know what is available before a workflow starts
Ask your Agent to call system_status before Office, ebook, DjVu, XPS, Ghostscript or PDF/A work. It reports installed programs, enabled tools and platform-specific setup instructions for anything missing.
$ Ask 1PDF to check its available capabilities
✓ Core PDF tools ready
✓ Node.js detected
→ Optional converters reported individually
Ready to use
Turn a PDF request into a completed file.
Install the free MCP server, attach your files to your Agent, and describe the result you want.