Use the localipdf PDF tools from Claude Desktop, Claude Code, Codex and other local MCP clients. Ask in plain words, for example "make report.pdf in my Downloads smaller than 1 MB" or "merge invoice.pdf and receipt.pdf on my Desktop". The result is saved as a new file next to the original, and existing files are never overwritten.
The server serves its bundled copy of the localipdf tools on 127.0.0.1 and opens them in a separate, temporary browser profile on your computer. That browser starts with every hostname except 127.0.0.1 blocked, so the page that processes your PDF cannot reach the internet.
Your AI client still receives what you type and what the tools report: file paths, status messages and, for some tools such as Edit PDF, document text. Its own data policy applies to that information.
Related MCP server: mcp-pdf-utils
Full policy: https://localipdf.com/privacy/
Data collection: the add-on collects nothing. It does not send information to localipdf or anyone else, and analytics do not run inside it.
Usage and storage: your PDFs are processed in the temporary browser profile described above, and results are saved as new files next to your originals.
Third-party sharing: none by the add-on. Your AI client receives your prompts and the tool responses, as described above.
Retention: the temporary browser profile and download folders are deleted when the add-on closes.
Contact: privacy@localipdf.com
Node.js 20 or newer
Chrome, Edge, Chromium or Brave. For an unusual install location, set LOCALIPDF_BROWSER to the browser's executable.
macOS, Windows or Linux
As a Claude Code plugin: run these two commands in Claude Code:
/plugin marketplace add Snake-deb/localipdf-mcp
/plugin install localipdf@localipdfThe plugin starts the server with node ${CLAUDE_PLUGIN_ROOT}/server.mjs, so Node.js must be installed. It is a local server, so it works in Claude Code and Cowork on your computer, not in claude.ai in a web browser.
From the release files: download them from Releases, or from localipdf.com/claude.
Claude Desktop: open localipdf.mcpb and confirm. Claude Desktop may show a warning because the extension is not in its directory.
Claude Code: extract localipdf-mcp.zip, keep its files together, then run:
claude mcp add localipdf -- node "/absolute/path/localipdf-mcp/server.mjs"Codex: extract the ZIP, then run:
codex mcp add localipdf -- node "/absolute/path/localipdf-mcp/server.mjs"For large jobs in Codex, add tool_timeout_sec = 960 to the existing [mcp_servers.localipdf] section of ~/.codex/config.toml. The server stops a job after 15 minutes.
Other local MCP clients: register server.mjs as a local stdio server run with node.
After installing, ask your assistant to list the localipdf tools, then try merging two test PDFs and open the result.
The server offers four MCP operations:
Operation | What it does |
| Lists the PDF tools and whether each one runs here |
| Reads a tool's help, options and limits |
| Lists a tool's options for the files you name |
| Runs a tool on files on this computer and saves the results |
Most localipdf tools run here, including Compress PDF, Merge PDF, Split PDF, Protect PDF, Unlock PDF, PDF to Word, Annotate PDF, Edit PDF and Redact PDF. Tools that need hands-on work, such as Sign PDF and Organize PDF, stay on the website; list_pdf_tools marks them with runs_here: false. Text recognition (OCR) is not included.
Everything the plugin does happens on your computer:
Claude starts node server.mjs from this folder. It needs no npm install and downloads nothing.
The server reads site/ from this folder and serves it on 127.0.0.1, on a free port chosen when it starts.
It opens your installed Chrome, Edge, Chromium or Brave with a new temporary profile and the flag --host-resolver-rules=MAP * ~NOTFOUND, EXCLUDE 127.0.0.1, which blocks every hostname except 127.0.0.1.
It reads only the files you name, saves results as new files in the folder you name, and never overwrites a file.
When it closes, it deletes the temporary profile and download folders.
It makes no requests to localipdf.com or any other remote server. The code in site/ is the built localipdf.com website, so it is minified; server.mjs and driver.js are plain JavaScript you can read.
Environment variables read: LOCALIPDF_BROWSER (an optional path to the browser, set by the person) and, on Windows, LOCALAPPDATA, PROGRAMFILES and PROGRAMFILES(X86), only to find where Chrome or Edge is installed. None of them is a credential, and none is sent anywhere.
Binary files in site/: WebAssembly builds of the engines the website uses (PDF.js image and colour decoders and its form-script sandbox, MozJPEG, QPDF as qpdf-core.bin, and an image resizer), fonts, CMap files for PDF text, and site/licenses/eigen-source/, the Eigen source archive kept with the licence notices. The browser profile runs the WebAssembly; nothing runs the archive.
Minified code: site/ is the built localipdf.com website, the same files served at https://localipdf.com. server.mjs and driver.js are plain JavaScript.
Compare the file you downloaded with SHA256SUMS in the release:
shasum -a 256 localipdf.mcpb localipdf-mcp.zipThe package does not update itself. Download the new release, test it on a spare PDF, then point your client at the new folder and reload it.
The package is free to use. See LICENSE. It includes open-source components under their own licences; their full texts are in site/licenses/.
support@localipdf.com. Please don't send private documents or passwords; a sample with made-up details is enough to reproduce most problems.
This server cannot be deployed
Split, merge and compress PDF files locally - private by design, no uploads.
Privacy-first PDF tools over MCP: merge, split, rotate, delete, compress, protect, inspect.
MCP server for Api2Pdf — generate PDFs & images from HTML, URLs or office files; merge, barcodes.
MCP server for the PDFGate API. Generate PDFs, manage documents and handle e-signatures.
