# GuruPDF

> GuruPDF is a freemium MCP server for files and documents. Convert, compress, merge and split PDFs and 100+ file formats from your AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Repository:** https://github.com/gurupdf/gurupdf-mcp
- **MCP Registry name:** io.github.GuruPDF/gurupdf-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Google_sheets](https://ai-powered.com/mcp/google-sheets-3): Google_sheets is a freemium MCP server for files and documents.
- [Onedrive](https://ai-powered.com/mcp/onedrive): Onedrive is a freemium MCP server for files and documents.
- [Zovo Spreadsheet Compare](https://ai-powered.com/mcp/zovo-spreadsheet-compare): Zovo Spreadsheet Compare is an MCP server for files and documents.
- [Video to Audio Converter MCP](https://ai-powered.com/mcp/video-to-audio-converter-mcp): Video to Audio Converter MCP is a free MCP server for design and media.
- [Google_drive](https://ai-powered.com/mcp/google-drive-5): Google_drive is a freemium MCP server for files and documents.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/gurupdf
