GuruPDF

io.github.GuruPDFPublished by GitHub account GuruPDFv0.1.5Updated Nov 7, 2026

Convert, compress & merge PDFs and 100+ file formats from any AI agent. By GuruPDF.

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

GuruPDF lets an assistant convert, compress, merge, split and edit PDFs and convert between 100+ file formats, reading and writing files on your machine.

What you can do
  • Convert and process local files or URLs to a target format such as PDF, PNG or DOCX, or via a tool slug like compress-pdf or merge-pdf, saving results to disk
  • Merge, split, rotate, protect and watermark PDFs, plus OCR and ebook and image conversions
  • Check a conversion job by id and download the result when ready, for long jobs such as video
  • List supported conversions and tools, optionally filtered by input format
  • Show remaining credits and how to get more
When to use it
Useful when you want an assistant to handle everyday document chores on local files — turning a Word invoice into a PDF, compressing a report, merging several PDFs, or saving a web page as a PDF — without manual uploads and downloads.
Requirements
Node.js 18+ and a free GuruPDF API key set in GURUPDF_API_KEY, obtained from the GuruPDF profile page. Runs locally via npx; GURUPDF_API_URL can override the API base URL for self-hosting. Network access to GuruPDF's servers is required.
Before you install
Conversions run on GuruPDF's servers, so the files you convert are uploaded to a third party, though the README says they are deleted within an hour. Each tool costs credits; free accounts get daily credits with rate limits, and topping up or upgrading involves payment. The API key is a secret to keep out of shared configs. The server reads and writes files on disk, and protect-pdf takes a password as an option.

Installation

In SourceWeft

  1. Open GuruPDF in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

GuruPDF MCP — convert PDFs & 100+ file formats from your AI agent

[npm version] [License: MIT] [gurupdf-mcp 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.

Languages: English · Español · Français · Deutsch · 中文 · Русский · Українська · Polski · Nederlands · Türkçe · Čeština · Ελληνικά · العربية

Ask your assistant: "compress this PDF", "turn invoice.docx into a PDF", or "merge these three files" — and it converts the files right on your machine.

  • 🗂️ 127 tools — PDF ⇄ Word/Excel/PowerPoint, images, ebooks, OCR, compress, merge, split, rotate, protect, watermark, and more.
  • 💻 Works on your local files — reads and writes files on disk, no manual upload/download.
  • 🆓 Free to start — every account gets daily credits. No credit card required.

Install

You need Node.js 18+ and a free GuruPDF API key:

  1. Sign up at gurupdf.com.
  2. Open Profile → API tokens and create a token.
  3. Add the server to your agent with that key (configs below). No install step — npx fetches it on first run.

Claude Desktop

claude_desktop_config.json:

json
{  "mcpServers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

json
{  "mcpServers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

VS Code

.vscode/mcp.json:

json
{  "servers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

Windsurf

~/.codeium/windsurf/mcp_config.json:

json
{  "mcpServers": {    "gurupdf": {      "command": "npx",      "args": ["-y", "gurupdf-mcp"],      "env": { "GURUPDF_API_KEY": "your_token_here" }    }  }}

Tools

ToolWhat it does
convert_fileConvert/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 disk.
get_statusCheck a conversion job by id and download the result when ready (for long jobs like video).
list_conversionsList supported conversions/tools, optionally filtered by an input format.
check_creditsShow remaining credits and how to get more.

Examples

"Compress ~/Documents/report.pdf." → convert_file(input: "~/Documents/report.pdf", to: "compress-pdf")

"Convert invoice.docx to PDF." → convert_file(input: "invoice.docx", to: "pdf")

"Merge a.pdf and b.pdf into one." → convert_file(input: ["a.pdf", "b.pdf"], to: "merge-pdf")

"Password-protect this PDF with hunter2." → convert_file(input: "secret.pdf", to: "protect-pdf", options: { password: "hunter2" })

"Save this web page as a PDF: https://example.com" → convert_file(input: "https://example.com", to: "url-to-pdf")

Free tier & credits

Each tool costs a few credits. Free accounts get daily credits (refreshed every day) and 2 conversions/minute, 10/day. When you run out, the assistant will tell you — you can wait for the daily refresh or top up / upgrade. Conversions run on GuruPDF's servers; files are deleted automatically within an hour.

Configuration

Env varDefaultNotes
GURUPDF_API_KEY—Required. Your API token from Profile → API tokens.
GURUPDF_API_URLhttps://gurupdf.com/api/v1Override only for self-hosted / staging.

Links

[gurupdf-mcp MCP server]

License

MIT

Source: README.md at commit 244d7cc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.5LatestNov 7, 2026
  2. v0.1.4Sep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts