GuruPDF
Convert, compress, merge and split PDFs and 100+ file formats from your AI agent
- 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-mcpAdd 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)RequiredGURUPDF_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.
