# PDFMonkey

> PDFMonkey is a freemium MCP server for files and documents. Generate PDFs from existing PDFMonkey templates and check quota from an assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** API, CLI
- **Website:** https://pdfmonkey.io
- **Repository:** https://github.com/pdfmonkey/pdfmonkey-mcp
- **MCP Registry name:** io.github.pdfmonkey/pdfmonkey-mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-15

## About

This is the official local server for PDFMonkey, a document-generation API where a template is designed once and filled with JSON. It runs over stdio with Node.js 18 or later and reads your key from `PDFMONKEY_API_KEY`; no Docker image is published yet, but a Dockerfile is included for local builds.

It works with templates that already exist. The README says it can read them but not create or edit them, and points to the separate PDFMonkey CLI for agents that should build and preview templates. `generate_document` waits for the result, polling every 1.5 seconds for up to 3 minutes, and `get_document_status` can be called later if a job runs longer. Download URLs expire after one hour, with permanent share links reserved for Pro+ and Premium plans.

Beyond the tools, it exposes four prompts: `list-templates-formatted`, `show-documents-status`, `generate-invoice` and `workspace-overview`. The wider product renders in a Chrome-based browser, produces PDF, PNG, WebP or JPG, hosts in the EU and can apply Factur-X EN 16931 for e-invoices.

## Features

- **Template browsing:** List workspaces and templates, and read a template's HTML, CSS and sample data.
- **Document generation:** Generate a document from a template and wait for the finished file.
- **Status and cleanup:** Check a document's status and download URL, list documents, or delete one.
- **Snippet access:** List and read the Liquid snippets of a workspace.
- **Quota check:** See your plan and remaining quota from the assistant.
- **Four built-in prompts:** Ready prompts for template lists, document status, invoices and workspace overviews.

## Good for

- Generate an invoice from an existing template with data from the chat
- Check how many documents are left this month
- Find documents that failed or are still pending
- Review a template's HTML and sample data
- Delete generated documents that should not be kept

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

```json
{
  "mcpServers": {
    "pdfmonkey-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pdfmonkey-mcp-server"
      ],
      "env": {
        "PDFMONKEY_API_KEY": "<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": "<PDFMONKEY_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `list_workspaces`: List the workspaces your API key can access.
- `list_templates`: List the templates of a workspace.
- `get_template`: Get a template's HTML, CSS and sample data.
- `generate_document`: Generate a document and wait for it.
- `get_document_status`: Check a document's status and get its download URL.
- `list_documents`: List documents filtered by status, template or update time.
- `delete_document`: Delete a document permanently.
- `list_snippets`: List the Liquid snippets of a workspace.
- `get_snippet`: Get a snippet's code.
- `get_quota`: Get your quota and plan.
- `get_user_info`: Get your account details.

## FAQ

### Can it create or edit templates?

No. It only reads existing templates; the PDFMonkey CLI is suggested for building and previewing templates.

### How long do download links last?

One hour. Download right away, or use a share link on Pro+ and Premium plans.

### What if generation takes long?

generate_document waits up to 3 minutes; after that call get_document_status with the document ID.

### Is there a free plan?

Yes, 20 documents a month free, and a 30-day trial with 300 documents.

### Is PDFMonkey free?

PDFMonkey has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

### How do I add PDFMonkey to Claude Code?

Run this command in your terminal: claude mcp add pdfmonkey-mcp --env PDFMONKEY_API_KEY='<PDFMONKEY_API_KEY>' -- npx -y pdfmonkey-mcp-server

### What are the best alternatives to PDFMonkey?

The closest alternatives to PDFMonkey are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/pdfmonkey
