Guru PDF MCP Server

A free Model Context Protocol (MCP) server that lets Claude, Cursor, VS Code, Windsurf and other AI agents convert, compress, merge, split and edit PDFs - and convert between 100+ file formats (Word, Excel, PowerPoint, JPG, PNG, HEIC, ebooks, and more), right on your own machine. Powered by GuruPDF. Its 4 documented tools cluster into read & search, convert, check.

People who work with compress pdf and document conversion and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-19 · ★ 2 · #128 OF 173 MAINTAINED MEDIA · VERIFIED 2026-09-18

MIT · JavaScript servers · how we verify → /methodology

01 · Install Guru PDF

before you install - you'll need

GURUPDF_API_KEY

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add gurupdf-gurupdf-mcp -- npx -y gurupdf-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "gurupdf-gurupdf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gurupdf-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package gurupdf-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.GuruPDF is GitHub-verified and matches the repo owner

03 · What Guru PDF can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can check a conversion job by id and download the result when ready (for long jobs like video), and list supported conversions/tools, optionally filtered by an input format.

Capability map

Tools grouped from the project's README - what Guru PDF lets an agent do.

read & search

2 tools - e.g. Check a conversion job by id and download the result when ready (for long jobs like video).; List supported conversions/tools, optionally filtered by an input format.

get_status · list_conversions

Convert

1 tool - e.g. Convert/process a local file (or URL). Give it an input and a target format (pdf, png, docx…) or a tool slug (compress-pdf, merge-pdf…). Saves the result to dis

convert_file

Check

1 tool - e.g. Show remaining credits and how to get more.

check_credits

Latest releases

v0.1.4 · 2026-06-19

What's new · Dockerfile for Glama (and container) deployment · glama.json for Glama directory ownership claim · Glama badges (card + score) in README · RELEASING.md documenting npm + MCP registry release steps…

v0.1.3 · 2026-06-16

Docs-only release. · README now links the /mcp landing page ( and the launch guide ( · No code changes since v0.1.2. · npx gurupdf-mcp ·

v0.1.2 · 2026-06-16

GuruPDF MCP v0.1.2 · Convert, compress, merge, split, and OCR PDFs - and convert between 100+ file formats (Word, Excel, PowerPoint, images, e‑books, video) - directly from any AI agent (Claude, Cursor, VS Code…

04 · Who maintains Guru PDF

GuruPDF is maintained by gurupdf. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/gurupdf/gurupdf-mcp
category: media - ranked #128 of 173 actively-maintained media servers as of 2026-09-18.
registry: io.github.GuruPDF/gurupdf-mcp (active, first published 2026-06-16 · 3 versions)
packages: npm:gurupdf-mcp

06 · Guru PDF FAQ

Is Guru PDF still maintained?

Yes - as of 2026-09-18, its last commit was 2026-06-19. We re-verify nightly.

What can Guru PDF do?

How do I install Guru PDF?

Run `npx -y gurupdf-mcp`. The README documents one environment variable (GURUPDF_API_KEY) to set first. You can also paste the ready-made client config above.

Does Guru PDF run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Guru PDF

Alternatives to Guru PDF

Maintained media servers if Guru PDF isn't the fit.

More media MCP servers · Visuals MCP · Le Clap · Shots · Gemini

More JavaScript MCP servers · Multi Gmail MCP · Hackle · ServiceNow Nodejs · Unified AI System MCP Gateway · Arduino MCP Server (hardware-mcp) · see all