Simple PDF API — MCP Server

Use Simple PDF API tools directly inside Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

8 tools available: html_to_pdf, url_to_pdf, merge_pdfs, split_pdf, watermark_pdf, compress_pdf, protect_pdf, rotate_pdf, extract_text.

Prerequisites

• A RapidAPI key (free tier available)
• Python 3.10+ and uv installed

Setup

Option A — uvx (no install needed)

PDF_API_KEY=your_rapidapi_key uvx --from "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp" pdf-api-mcp

Option B — local clone

git clone https://github.com/mahiuddinalkamal/pdf-api
cd pdf-api/mcp
uv run server.py

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pdf-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp",
        "pdf-api-mcp"
      ],
      "env": {
        "PDF_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see PDF tools in the toolbar.

Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "pdf-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp",
        "pdf-api-mcp"
      ],
      "env": {
        "PDF_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "pdf-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp",
        "pdf-api-mcp"
      ],
      "env": {
        "PDF_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

Tools

All output files are saved to ~/Downloads/.

Environment Variables