Claude Code + pdfmcp: setup guide

Add pdfmcp to Claude Code with one command, or via .mcp.json.

What you need: a free pdfmcp API key — sign in with your email (no password) and copy the key shown at first login. Then replace pdfmcp_live_YOUR_KEY in the config below.

Where it goes: Terminal, or a .mcp.json file in your project

claude mcp add --transport http pdfmcp https://mcp.pdfmcp.org/mcp --header "Authorization: Bearer pdfmcp_live_YOUR_KEY"

Steps

Get a free API key from the pdfmcp dashboard.
Run the command above (or add the JSON below to .mcp.json in your project root).
Restart Claude Code and run /mcp to confirm pdfmcp is connected.
Try: “Use pdfmcp to merge these two PDFs” or “…to OCR this scan”.

Project-scoped .mcp.json alternative:

Config

{
  "mcpServers": {
    "pdfmcp": {
      "type": "http",
      "url": "https://mcp.pdfmcp.org/mcp",
      "headers": {
        "Authorization": "Bearer pdfmcp_live_YOUR_KEY"
      }
    }
  }
}

Troubleshooting

401 / unauthorized: the key header is missing or mistyped. The header name is exactly X-API-Key (Claude Code uses Authorization: Bearer … — both work).
Tools don't appear: fully restart the client after editing its config; most clients only load MCP servers at startup.
Server unreachable: check the public status page — and your network's outbound HTTPS to mcp.pdfmcp.org.

Try it with

On-deviceMerge PDFsCombine multiple PDF files into one, in upload order.On-devicePDF to textExtract plain text, one form-feed separated section per page.On-deviceCompress PDFReduce file size with Ghostscript. Presets: light (printer quality), medium (ebook), heavy (screen, smallest).

More clients: Claude Desktop MCP setup · ChatGPT MCP setup · Cursor MCP setup · All MCP setup guides · REST API quickstart