English Français العربية

PDFMonkey

Official registry Other

Generate PDFs from templates using the PDFMonkey API

Source code Website Documentation

What can you do with PDFMonkey?

  • Download URLs expire after one hour. Download the file right away, or use a share link (Pro+ and Premium plans).
  • If a generation takes longer than 3 minutes, call get_document_status later with the document ID.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package pdfmonkey-mcp-server
Claude Code 
claude mcp add pdfmonkey -e 'PDFMONKEY_API_KEY=<your pdfmonkey_api_key>' -- npx -y pdfmonkey-mcp-server@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pdfmonkey": {
            "command": "npx",
            "args": [
                "-y",
                "pdfmonkey-mcp-server@1.0.1"
            ],
            "env": {
                "PDFMONKEY_API_KEY": "<your pdfmonkey_api_key>"
            }
        }
    }
}

Environment variables

  • PDFMONKEY_API_KEY required secret Your PDFMonkey API key from https://dashboard.pdfmonkey.io/account

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PDFMonkey MCP Server
  2. Get your API key
  3. Setup
  4. Tools
  5. Example
  6. Development
  7. Troubleshooting
  8. Resources
  9. License

PDFMonkey MCP Server

The official Model Context Protocol (MCP) server for PDFMonkey. It lets AI assistants such as Claude, Cursor or any other MCP client list your templates, generate documents and check your quota through the PDFMonkey API.

The MCP server works with existing templates: it can read them but not create or edit them. To let an agent build and preview templates, use the PDFMonkey CLI.

Get your API key

Sign up at dashboard.pdfmonkey.io/register, then copy your API key from your account page.

Setup

The server needs Node.js 18 or later and reads your key from the PDFMONKEY_API_KEY environment variable.

Claude Code
claude mcp add pdfmonkey -e PDFMONKEY_API_KEY=your-api-key -- npx -y pdfmonkey-mcp-server
Claude Desktop, Cursor and other clients

Add this to your client’s MCP configuration (claude_desktop_config.json for Claude Desktop, .cursor/mcp.json for Cursor):

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "npx",
      "args": ["-y", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop’s configuration file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Docker

No image is published yet, so build it locally:

docker build -t pdfmonkey-mcp-server .
{
  "mcpServers": {
    "pdfmonkey": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PDFMONKEY_API_KEY", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

See DOCKER-MCP-TOOLKIT.md to use it with the Docker MCP Toolkit.

Tools

ToolWhat it does
list_workspacesList the workspaces your API key can access
list_templatesList the templates of a workspace
get_templateGet a template’s HTML, CSS and sample data
generate_documentGenerate a document and wait for it (polls every 1.5 s, up to 3 minutes)
get_document_statusCheck a document’s status and get its download URL
list_documentsList documents, filtered by status, template or update time
delete_documentDelete a document permanently
list_snippetsList the Liquid snippets of a workspace
get_snippetGet a snippet’s code
get_quotaGet your quota and plan
get_user_infoGet your account details

The server also exposes four prompts: list-templates-formatted, show-documents-status, generate-invoice and workspace-overview.

Good to know:

  • Download URLs expire after one hour. Download the file right away, or use a share link (Pro+ and Premium plans).
  • If a generation takes longer than 3 minutes, call get_document_status later with the document ID.

Example

You: Generate an invoice for ACME with my invoice template.

Claude: [calls list_templates, then generate_document]
Your invoice is ready: https://…

Development

npm install
npm run build      # compile to dist/
npm test           # run the test suite
npm run watch      # rebuild on change

To try the server against the real API:

PDFMONKEY_API_KEY=your-api-key npm start

Troubleshooting

  • “PDFMONKEY_API_KEY environment variable is required”: the key is missing from your client configuration.
  • 401 errors: the key is wrong or was regenerated. Copy it again from your account page.
  • Docker container exits immediately: run it with -i, MCP talks over stdin.

Resources

Questions about the server? Open an issue. Questions about PDFMonkey itself? Contact us.

License

MIT, see LICENSE.

Frequently asked questions

What is PDFMonkey?

Generate PDFs from templates using the PDFMonkey API

How do I install PDFMonkey?

It runs on your machine. In Claude Code: claude mcp add pdfmonkey -e 'PDFMONKEY_API_KEY=<your pdfmonkey_api_key>' -- npx -y pdfmonkey-mcp-server@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does PDFMonkey need an API key?

Yes. It expects PDFMONKEY_API_KEY, which you set in its configuration.

Is PDFMonkey open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains PDFMonkey?

It is published by pdfmonkey. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.