Log inSubmit server
Gurupdf MCP logo

Gurupdf MCP

by GuruPDF

Convert, compress, merge, split, OCR, and transform local files through GuruPDF using an MCP-compatible AI client.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Gurupdf MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gurupdf-gurupdf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gurupdf-mcp"
      ],
      "env": {
        "GURUPDF_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y gurupdf-mcp

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

GuruPDF/gurupdf-mcp MCP server lets AI agents convert and process local files through the GuruPDF API. Its main tool accepts a file path or URL plus a target format or PDF operation, then saves the result beside the input file. It also exposes job-status, supported-conversion, and credit-check tools. Reach for it when an agent needs document conversion, PDF manipulation, or OCR without manual uploads and downloads.

Use cases

  • Convert invoices from DOCX to PDF
  • Compress large PDF reports
  • Merge multiple PDFs into one file
  • OCR scanned documents
  • Convert web pages into PDFs

Key features

  • Convert between 100+ file formats
  • Compress, merge, split, and edit PDFs
  • Run OCR on PDF files
  • Process local files or URLs
  • Track asynchronous conversion jobs
  • Check supported conversions and account credits

Tools4

What Gurupdf MCP lets your agent do. Expand a tool for its parameters.

Verified live~531 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

18/18 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · gurupdf-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads155Package downloads in the last 30 days.
Last commit4mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed4Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Gurupdf MCP works

What GuruPDF/gurupdf-mcp MCP server does

GuruPDF/gurupdf-mcp MCP server connects an MCP-compatible AI client to the GuruPDF API for document conversion and PDF processing. It can convert among PDF, Word, Excel, PowerPoint, image, ebook, and other formats, with support for more than 100 format combinations. PDF-focused operations include compression, merging, splitting, rotation, password protection, watermarking, and OCR.

The server works with files on the machine running the AI client. It can also accept a URL for supported operations, such as creating a PDF from a web page. Completed output is written to disk and the resulting path is returned to the agent.

How it works

The central convert_file tool receives a local path, a URL, or a list of input files. The caller supplies either a target format such as pdf, png, or docx, or a GuruPDF operation slug such as compress-pdf or merge-pdf. For multi-file workflows, the input can contain multiple paths.

Some conversions may run as asynchronous jobs. get_status checks a job by its UUID and downloads the output when processing is complete, which is useful for longer-running work such as video conversion. list_conversions reports available conversions and processing tools, with optional filtering by input format. check_credits reports the remaining account credits and explains how to obtain more.

GuruPDF/gurupdf-mcp MCP server sends conversions to GuruPDF’s servers rather than processing every operation locally.

Setup and configuration

Node.js 18 or newer is required. Create a free GuruPDF account, generate an API token under the profile’s API tokens page, and provide it as GURUPDF_API_KEY. The package can be launched with npx -y gurupdf-mcp, so a separate local installation step is not required.

Claude Desktop, Cursor, VS Code, and Windsurf configurations use the same command and environment variable. This listing specifically identifies Claude Desktop, Cursor, and Windsurf as compatible clients. The optional GURUPDF_API_URL variable defaults to https://gurupdf.com/api/v1 and can be changed for self-hosted or staging deployments.

Tools and capabilities

  • convert_file: Convert a file between supported formats or run a PDF operation; writes the result to disk.
  • get_status: Check an asynchronous conversion and download its completed result.
  • list_conversions: Discover supported conversions and tools, optionally by input format.
  • check_credits: Display the account’s remaining GuruPDF credits.
  • Handle PDF conversion, compression, merging, splitting, rotation, protection, watermarking, and OCR.
  • Convert among PDF, office documents, images, ebooks, video, and other supported formats.

GuruPDF/gurupdf-mcp MCP server uses account credits. Free accounts receive daily credits, with the README also documenting a limit of two conversions per minute and ten per day. Additional capacity is available through GuruPDF’s top-up or upgrade options.

Limitations and notes

An API key is required, even though the service has a free tier. Conversion work is performed on GuruPDF’s servers, so this tool may not fit workflows that require all file processing to remain offline. The documented free-tier limits and automatic deletion window should be considered when planning batch jobs or handling sensitive documents.

The configured input and output paths must be accessible to the local AI client process. For long-running jobs, an agent needs to retain the returned job ID and call get_status to retrieve the result.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Gurupdf MCP

Use Node.js 18 or newer and configure the server with `npx -y gurupdf-mcp`. No separate installation step is required.

Set `GURUPDF_API_KEY` to a GuruPDF API token created from the account’s Profile → API tokens page.

Yes. The README provides a Claude Desktop configuration using `npx -y gurupdf-mcp` and the `GURUPDF_API_KEY` environment variable.

Yes. Use `convert_file` with a local input path and `pdf` as the target format. The result is saved to disk and its path is returned.

No.

Related MCP servers

All in File Systems All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGurupdf MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gurupdf-gurupdf-mcp?style=directory)](https://allmcps.com/mcp/gurupdf-gurupdf-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/gurupdf-gurupdf-mcp"><img src="https://allmcps.com/api/badge/gurupdf-gurupdf-mcp?style=directory" alt="Gurupdf MCP on AllMCPs" /></a>