Skip to content
MCP server

GuruPDF

Convert, compress, merge and split PDFs and 100+ file formats from your AI agent

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.1.5
Listing updated
today

Similar MCP servers

About GuruPDF

GuruPDF is a freemium MCP server for files and documents. It runs locally on your machine and is started by your AI client.

GuruPDF's server is a thin local bridge: your assistant calls a small set of tools, the server reads and writes files on your own disk, and the actual conversion runs on GuruPDF's servers through its API. Uploaded files are deleted automatically within an hour, according to the README.

Instead of one tool per format, convert_file takes an input path or URL plus a target format such as pdf, png or docx, or a tool slug such as compress-pdf, merge-pdf, protect-pdf or url-to-pdf. The README says the underlying service offers 127 tools covering Word, Excel, PowerPoint, images, HEIC, ebooks, OCR, rotate, watermark and more.

It needs Node.js 18+ and a GuruPDF API key from your profile page. Free accounts get daily credits, limited to 2 conversions a minute and 10 a day; more credits can be bought.

Install

Run in a terminal

claude mcp add gurupdf-mcp --env GURUPDF_API_KEY='<GURUPDF_API_KEY>' -- npx -y gurupdf-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "gurupdf-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gurupdf-mcp"
      ],
      "env": {
        "GURUPDF_API_KEY": "<GURUPDF_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GURUPDF_API_KEYYour GuruPDF API token (create one at https://gurupdf.com/profile)Required
  • GURUPDF_API_URLAPI base URL; override only for self-hosting

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

convert_file
Convert or process a local file or URL to a target format or tool slug and save the result to disk.
get_status
Check a conversion job by id and download the result when ready.
list_conversions
List supported conversions and tools, optionally filtered by input format.
check_credits
Show remaining credits and how to get more.

What it does

One convert tool
convert_file handles format conversion and PDF operations through a target format or tool slug.
Works on local files
Reads inputs and saves results on disk, with no manual upload or download.
Long-job status
get_status checks a conversion job by id and fetches the result for slow jobs such as video.
Format discovery
list_conversions shows supported conversions, optionally filtered by input format.
Credit check
check_credits reports remaining credits and how to get more.
URL to PDF
Saves a web page as a PDF by passing its URL with the url-to-pdf slug.

Good for

  • Compress a large report PDF before emailing it
  • Turn a Word invoice into a PDF from chat
  • Merge several PDFs into one file
  • Password-protect a PDF
  • Save a web page as a PDF

Pricing

Freemium

Free daily credits (10 conversions a day); paid top-up and upgrade plans, prices on the GuruPDF site

GuruPDF FAQ

Do I need an API key?

Yes. Create a GuruPDF API token in your profile and pass it as GURUPDF_API_KEY.

What are the free limits?

Free accounts get daily credits, 2 conversions per minute and 10 per day.

Where do conversions run?

On GuruPDF's servers; files are removed automatically within an hour.

Which clients are shown in the setup?

Claude Desktop, Cursor, VS Code and Windsurf, all launching it with npx.

Is GuruPDF free?

GuruPDF has a free plan, with paid plans for more usage or features.

How do I add GuruPDF to Claude Code?

Run this command in your terminal: claude mcp add gurupdf-mcp --env GURUPDF_API_KEY='<GURUPDF_API_KEY>' -- npx -y gurupdf-mcp

What are the best alternatives to GuruPDF?

The closest alternatives to GuruPDF are SSRS2, Csv, Google_sheets, Onedrive and Zovo Spreadsheet Compare.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers