# PDFMonkey MCP server

> Allows AI assistants to list templates, generate documents, and check usage quotas through the PDFMonkey API.

- Repository: https://github.com/pdfmonkey/pdfmonkey-mcp
- Page: https://hostedmcp.org/servers/pdfmonkey/pdfmonkey-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.0.1

## Install

### Claude Code

```sh
claude mcp add --env 'PDFMONKEY_API_KEY=<YOUR_PDFMONKEY_API_KEY>' pdfmonkey-mcp -- npx -y pdfmonkey-mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "pdfmonkey-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pdfmonkey-mcp-server"
      ],
      "env": {
        "PDFMONKEY_API_KEY": "<YOUR_PDFMONKEY_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "pdfmonkey-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pdfmonkey-mcp-server"
      ],
      "env": {
        "PDFMONKEY_API_KEY": "<YOUR_PDFMONKEY_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"pdfmonkey-mcp","type":"stdio","command":"npx","args":["-y","pdfmonkey-mcp-server"],"env":{"PDFMONKEY_API_KEY":"<YOUR_PDFMONKEY_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "pdfmonkey-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pdfmonkey-mcp-server"
      ],
      "env": {
        "PDFMONKEY_API_KEY": "<YOUR_PDFMONKEY_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add pdfmonkey-mcp --env 'PDFMONKEY_API_KEY=<YOUR_PDFMONKEY_API_KEY>' -- npx -y pdfmonkey-mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.pdfmonkey-mcp]
command = "npx"
args = ["-y", "pdfmonkey-mcp-server"]

[mcp_servers.pdfmonkey-mcp.env]
PDFMONKEY_API_KEY = "<YOUR_PDFMONKEY_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'PDFMONKEY_API_KEY=<YOUR_PDFMONKEY_API_KEY>' pdfmonkey-mcp npx -- -y pdfmonkey-mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "pdfmonkey-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pdfmonkey-mcp-server"
      ],
      "env": {
        "PDFMONKEY_API_KEY": "<YOUR_PDFMONKEY_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PDFMONKEY_API_KEY` | yes | yes | Your PDFMonkey API key from https://dashboard.pdfmonkey.io/account |

## Tools (11)

- `list_workspaces`
- `list_templates`
- `get_template`
- `generate_document`
- `get_document_status`
- `list_documents`
- `delete_document`
- `list_snippets`
- `get_snippet`
- `get_quota`
- `get_user_info`

## FAQ

### Can the MCP server create or edit templates?

No, the server can read existing templates but cannot create or edit them. You should use the PDFMonkey CLI for building and previewing templates.

### How long do PDF download URLs last?

Download URLs are temporary and will expire after one hour.

### What should I do if a document generation takes longer than 3 minutes?

If the process exceeds 3 minutes, you should use the get_document_status tool with the document ID at a later time.