{
  "markdown": "# GuruPDF MCP — convert PDFs & 100+ file formats from your AI agent\n\n[![npm version](https://img.shields.io/npm/v/gurupdf-mcp.svg)](https://www.npmjs.com/package/gurupdf-mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/GuruPDF/gurupdf-mcp/blob/main/LICENSE)\n[![gurupdf-mcp MCP server](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp/badges/score.svg)](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp)\n\nA free **[Model Context Protocol](https://modelcontextprotocol.io) (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](https://gurupdf.com).\n\n**Languages:** English · [Español](i18n/README.es.md) · [Français](i18n/README.fr.md) · [Deutsch](i18n/README.de.md) · [中文](i18n/README.zh.md) · [Русский](i18n/README.ru.md) · [Українська](i18n/README.uk.md) · [Polski](i18n/README.pl.md) · [Nederlands](i18n/README.nl.md) · [Türkçe](i18n/README.tr.md) · [Čeština](i18n/README.cs.md) · [Ελληνικά](i18n/README.el.md) · [العربية](i18n/README.ar.md)\n\n> 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.\n\n- 🗂️ **126 tools** — PDF ⇄ Word/Excel/PowerPoint, images, ebooks, OCR, compress, merge, split, rotate, protect, watermark, and more.\n- 💻 **Works on your local files** — reads and writes files on disk, no manual upload/download.\n- 🆓 **Free to start** — every account gets daily credits. No credit card required.\n\n## Install\n\nYou need **Node.js 18+** and a free **GuruPDF API key**:\n\n1. Sign up at **[gurupdf.com](https://gurupdf.com)**.\n2. Open **[Profile → API tokens](https://gurupdf.com/profile)** and create a token.\n3. Add the server to your agent with that key (configs below). No install step — `npx` fetches it on first run.\n\n### Claude Desktop\n\n`claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"gurupdf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gurupdf-mcp\"],\n      \"env\": { \"GURUPDF_API_KEY\": \"your_token_here\" }\n    }\n  }\n}\n```\n\n### Cursor\n\n`~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project):\n\n```json\n{\n  \"mcpServers\": {\n    \"gurupdf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gurupdf-mcp\"],\n      \"env\": { \"GURUPDF_API_KEY\": \"your_token_here\" }\n    }\n  }\n}\n```\n\n### VS Code\n\n`.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"gurupdf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gurupdf-mcp\"],\n      \"env\": { \"GURUPDF_API_KEY\": \"your_token_here\" }\n    }\n  }\n}\n```\n\n### Windsurf\n\n`~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"gurupdf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"gurupdf-mcp\"],\n      \"env\": { \"GURUPDF_API_KEY\": \"your_token_here\" }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | What it does |\n|------|--------------|\n| `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. |\n| `get_status` | Check a conversion job by id and download the result when ready (for long jobs like video). |\n| `list_conversions` | List supported conversions/tools, optionally filtered by an input format. |\n| `check_credits` | Show remaining credits and how to get more. |\n\n### Examples\n\n> **\"Compress `~/Documents/report.pdf`.\"**\n> → `convert_file(input: \"~/Documents/report.pdf\", to: \"compress-pdf\")`\n\n> **\"Convert `invoice.docx` to PDF.\"**\n> → `convert_file(input: \"invoice.docx\", to: \"pdf\")`\n\n> **\"Merge `a.pdf` and `b.pdf` into one.\"**\n> → `convert_file(input: [\"a.pdf\", \"b.pdf\"], to: \"merge-pdf\")`\n\n> **\"Password-protect this PDF with `hunter2`.\"**\n> → `convert_file(input: \"secret.pdf\", to: \"protect-pdf\", options: { password: \"hunter2\" })`\n\n> **\"Save this web page as a PDF: https://example.com\"**\n> → `convert_file(input: \"https://example.com\", to: \"url-to-pdf\")`\n\n## Free tier & credits\n\nEach 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](https://gurupdf.com/pricing). Conversions run on GuruPDF's servers; files are deleted automatically within an hour.\n\n## Configuration\n\n| Env var | Default | Notes |\n|---------|---------|-------|\n| `GURUPDF_API_KEY` | — | **Required.** Your API token from [Profile → API tokens](https://gurupdf.com/profile). |\n| `GURUPDF_API_URL` | `https://gurupdf.com/api/v1` | Override only for self-hosted / staging. |\n\n## Links\n\n- Glama: [gurupdf-mcp on Glama](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp)\n\n[![gurupdf-mcp MCP server](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp/badges/card.svg)](https://glama.ai/mcp/servers/GuruPDF/gurupdf-mcp)\n\n- Landing page: [gurupdf.com/mcp](https://gurupdf.com/mcp)\n- Guide: [Convert files in Claude & Cursor with the GuruPDF MCP](https://gurupdf.com/blog/file-conversion-mcp-for-claude-and-cursor)\n- Website: [gurupdf.com](https://gurupdf.com)\n- API docs: [gurupdf.com/api/docs](https://gurupdf.com/api/docs)\n- Pricing: [gurupdf.com/pricing](https://gurupdf.com/pricing)\n\n## License\n\nMIT\n",
  "bytes": 5340,
  "sha": "5d7469ee5095fc1ba49297d246550c8ae7654ab5271f6b68b94f3b18ed22c85d",
  "repo_slug": "gurupdf/gurupdf-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gurupdf_gurupdf_mcp_53ca2d70/readme"
}