English Français العربية

GuruPDF

Official registry AI and agents

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package gurupdf-mcp
Claude Code 
claude mcp add gurupdf -e 'GURUPDF_API_KEY=<your gurupdf_api_key>' -e 'GURUPDF_API_URL=https://gurupdf.com/api/v1' -- npx -y gurupdf-mcp@0.1.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "gurupdf": {
            "command": "npx",
            "args": [
                "-y",
                "gurupdf-mcp@0.1.4"
            ],
            "env": {
                "GURUPDF_API_KEY": "<your gurupdf_api_key>",
                "GURUPDF_API_URL": "https://gurupdf.com/api/v1"
            }
        }
    }
}

Environment variables

  • GURUPDF_API_KEY required secret Your GuruPDF API token (create one at https://gurupdf.com/profile)
  • GURUPDF_API_URL API base URL; override only for self-hosting

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. GuruPDF MCP — convert PDFs & 100+ file formats from your AI agent
  2. Install
  3. Tools
  4. Free tier & credits
  5. Configuration
  6. Links
  7. License

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

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.

  • 🗂️ 126 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:

{
  "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):

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

.vscode/mcp.json:

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

~/.codeium/windsurf/mcp_config.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.

License

MIT

Frequently asked questions

What is GuruPDF?

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

How do I install GuruPDF?

It runs on your machine. In Claude Code: claude mcp add gurupdf -e 'GURUPDF_API_KEY=<your gurupdf_api_key>' -e 'GURUPDF_API_URL=https://gurupdf.com/api/v1' -- npx -y gurupdf-mcp@0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does GuruPDF need an API key?

Yes. It expects GURUPDF_API_KEY, which you set in its configuration.

Is GuruPDF open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains GuruPDF?

It is published by GuruPDF. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.