Pymupdf MCP Server

PyMuPDF compiled to WebAssembly - Full PDF manipulation in the browser

Local serverstdio

What is the Pymupdf MCP server?

PyMuPDF compiled to WebAssembly - Full PDF manipulation in the browser. Exposed over MCP by the pymupdf mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

  • Open — PDF, XPS, EPUB, and images
  • Convert — any supported format to PDF
  • Extract — text, images, and tables
  • Merge and Split — PDF documents
  • Page manipulation — - rotate, crop, delete, reorder
  • Annotations — - highlights, notes, shapes

Adding it to your client

The server ships on npm as @bentopdf/pymupdf-wasm, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Its toolset

Everything the assistant can do here goes through one of these:

  • Annotations — highlights, notes, shapes
  • Security — encrypt, decrypt, redact
  • Forms — read and fill form fields
  • PyMuPDF — © Artifex Software, Inc. (AGPL-3.0)
  • Ghostscript — © Artifex Software, Inc. (AGPL-3.0)
  • Pyodide — © Mozilla Foundation / Michael Droettboom (MPL-2.0)
  • pdf2docx — © Artifex Software, Inc. (AGPL-3.0)

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the pymupdf mcp server does with a few real requests.

When to reach for it

This sits in the browser automation group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Pymupdf's toolset — Annotations, Security, Forms and 4 more — is a fair guide to whether it matches your workflow. It is maintained by bentopdf; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
Annotationshighlights, notes, shapes
Securityencrypt, decrypt, redact
Formsread and fill form fields
PyMuPDF© Artifex Software, Inc. (AGPL-3.0)
Ghostscript© Artifex Software, Inc. (AGPL-3.0)
Pyodide© Mozilla Foundation / Michael Droettboom (MPL-2.0)
pdf2docx© Artifex Software, Inc. (AGPL-3.0)

How to install the Pymupdf MCP server

{
  "mcpServers": {
    "pymupdf": {
      "command": "npx",
      "args": ["-y", "@bentopdf/pymupdf-wasm"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Pymupdf to Annotations.
  • Use Pymupdf to Security.
  • Use Pymupdf to Forms.

Frequently asked questions

It connects Pymupdf to MCP-compatible AI assistants such as Claude and Cursor, exposing 7 tools (Annotations, Security, Forms, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Pymupdf directly.