How do I install Gurupdf?

Gurupdf is a local plugin. Install it using npm package: gurupdf-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Gurupdf need?

Gurupdf requires the following credentials or environment variables: GURUPDF_API_KEY, GURUPDF_API_URL. You can find setup instructions on the server detail page.

What AI apps work with Gurupdf?

Gurupdf uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Gurupdf MCP Server

by GuruPDF

Developer ToolsModerate5.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.2

Moderate5.2Moderate Risk

GuruPDF MCP is a well-structured server with proper authentication and no malicious patterns. The codebase demonstrates good security practices: API keys are required and loaded from environment variables (not hardcoded), input validation is present via Zod schemas, and sensitive errors are properly sanitized before being relayed to users. Permissions are appropriate for a file conversion tool (file I/O, network HTTP, env vars). Minor code quality observations exist but do not materially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

5 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Your GuruPDF API token (create one at https://gurupdf.com/profile)Required

Environment variable: GURUPDF_API_KEY

API base URL; override only for self-hostingOptional

Environment variable: GURUPDF_API_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-gurupdf-gurupdf-mcp": {
      "env": {
        "GURUPDF_API_KEY": "your-gurupdf-api-key-here",
        "GURUPDF_API_URL": "your-gurupdf-api-url-here"
      },
      "args": [
        "-y",
        "gurupdf-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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:

Sign up at gurupdf.com.
Open Profile → API tokens and create a token.
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

Tool	What it does
`convert_file`	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 disk.
`get_status`	Check a conversion job by id and download the result when ready (for long jobs like video).
`list_conversions`	List supported conversions/tools, optionally filtered by an input format.
`check_credits`	Show 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 var	Default	Notes
`GURUPDF_API_KEY`	—	Required. Your API token from Profile → API tokens.
`GURUPDF_API_URL`	`https://gurupdf.com/api/v1`	Override only for self-hosted / staging.

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Gurupdf MCP Server

About

Security Report

Findings (9)Action required

Permissions Required

What You'll Need

How to Install

Documentation

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

Install

Claude Desktop

Cursor

VS Code

Windsurf

Tools

Examples

Free tier & credits

Configuration

Links

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent

mcp-creator-typescript