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 connecting media tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-19 · ★ 2 · #103 OF 155 MAINTAINED MEDIA · VERIFIED 2026-08-25

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 #103 of 155 actively-maintained media servers as of 2026-08-25.
release cadence
3 releases in the last 90 days (latest 2026-06-19)
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-08-25, its last commit was 2026-06-19 and it shipped 3 releases in the last 90 days. We re-verify nightly.

What can Guru PDF do?

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.

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.

  1. Openshorts Turn long videos into viral vertical shorts and publish them to TikTok, Instagram and YouTube. ★ 3,410 · 2026-08-25
  2. Claude Real Video Let any LLM watch a video locally - and search everything it has ever watched. ★ 2,061 · 2026-08-22
  3. Voicemode Natural voice conversations for AI assistants - STT/TTS via MCP ★ 1,337 · 2026-08-09
  4. Nova3 D Structured, part-aware 3D generation for AI agents. Named-part GLB, preview URL, Blender script. ★ 682 · 2026-08-12
  5. Comfyui MCP MCP server + Claude Code plugin for ComfyUI: run workflows, generate images, manage models & VRAM. ★ 671 · 2026-08-25
  6. Yutu The AI-powered toolkit that grows your YouTube channel on autopilot ★ 620 · 2026-08-23

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