GuruPDF MCP Server

by gurupdfio.github.GuruPDF/gurupdf-mcpv0.1.4

Convert, compress, merge, split and OCR PDFs, and convert between Word, Excel, PowerPoint, image, ebook and video formats via the GuruPDF API.

2Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install GuruPDF MCP server

claude mcp add gurupdf -e GURUPDF_API_KEY='<gurupdf-api-key>' -- npx -y gurupdf-mcp

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": [
        "-y",
        "gurupdf-mcp"
      ],
      "env": {
        "GURUPDF_API_KEY": "<gurupdf-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": [
        "-y",
        "gurupdf-mcp"
      ],
      "env": {
        "GURUPDF_API_KEY": "<gurupdf-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "gurupdf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gurupdf-mcp"
      ],
      "env": {
        "GURUPDF_API_KEY": "<gurupdf-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "gurupdf": {
      "command": "npx",
      "args": [
        "-y",
        "gurupdf-mcp"
      ],
      "env": {
        "GURUPDF_API_KEY": "<gurupdf-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GURUPDF_API_KEY	yes	yes	Your GuruPDF API token (create one at https://gurupdf.com/profile)
GURUPDF_API_URL	—	—	API base URL; override only for self-hosting

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-06-19 · 4mo ago · GitHub
Latest release
2026-06-19 · 4mo ago · GitHub · v0.1.4
Package published
no data · npm/PyPI
Registry entry updated
2026-06-19 · 4mo ago · official registry · v0.1.4

FAQ

›How do I install the GuruPDF MCP server in Claude Code?

Run: claude mcp add gurupdf -e GURUPDF_API_KEY='<gurupdf-api-key>' -- npx -y gurupdf-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does GuruPDF require an API key?

Yes. It expects GURUPDF_API_KEY, of which 1 is a secret.

›Can I use GuruPDF as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is GuruPDF in the official MCP registry?

Yes, as io.github.GuruPDF/gurupdf-mcp.