1pdf MCP Server

Ten local PDF tools for Claude, Cursor, and Codex. Version 0.1.0 keeps PDF processing on your machine, so your files are not uploaded to a cloud service.

Quick start

Requires Node.js 18 or later.

Claude Code

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

Claude Desktop

Add this to claude_desktop_config.json:

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

Cursor or Windsurf

Add an MCP server with this command:

npx -y onepdf-mcp-server

Related MCP server: PDF Manipulation MCP Server

Available local tools in v0.1

All ten tools run locally. New outputs are published atomically and never replace an input or existing destination. Generated encryption uses AES-256; decryption supports AES-256 and RC4 password-protected PDFs, not every PDF encryption format.

Compression in v0.1 is lossless structural optimization, not a quality-reducing conversion. It preserves document metadata. PDFs that appear to contain signatures are copied byte-for-byte instead of being reserialized, because rewriting a signed document can invalidate its signatures.

Coming soon, cloud tools

The planned 1.0 cloud offering adds 86 more tools, including format conversion, editing, OCR, AI-assisted PDF workflows, optimization, and advanced security features.

Development and contributing

git clone https://github.com/WendongAI/onepdf-mcp-server.git
cd onepdf-mcp-server
npm ci
npm test
npm run build

Contributions and issue reports are welcome at github.com/WendongAI/onepdf-mcp-server.

License

MIT © 1pdf