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
This is a well-structured MCP server with proper authentication, clean code quality, and appropriate permission scoping for its file-conversion purpose. The server correctly requires an API key, validates inputs, handles errors gracefully, and makes only expected network calls to the GuruPDF API. No security vulnerabilities or malicious patterns detected. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
5 files analyzed · 7 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.
What You'll Need
Set these up before or after installing:
Environment variable: GURUPDF_API_KEY
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 GitHubFrom 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 —
npxfetches 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.docxto PDF." →convert_file(input: "invoice.docx", to: "pdf")
"Merge
a.pdfandb.pdfinto 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. |
Links
- Glama: gurupdf-mcp on Glama
- Landing page: gurupdf.com/mcp
- Guide: Convert files in Claude & Cursor with the GuruPDF MCP
- Website: gurupdf.com
- API docs: gurupdf.com/api/docs
- Pricing: gurupdf.com/pricing
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.