Back to Browse

Pdfmonkey MCP Server

Developer ToolsModerate7.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Generate PDFs from templates using the PDFMonkey API

About

Generate PDFs from templates using the PDFMonkey API

Security Report

7.2
Moderate7.2Low Risk

This is the official PDFMonkey MCP server. It reads its API key from the PDFMONKEY_API_KEY environment variable, sends it only as a Bearer token to api.pdfmonkey.io, and has no shell execution, filesystem access, or obfuscated code. The only findings are minor code quality issues: the HTTP client parses JSON before checking the response status, and some tools return raw API JSON, which may include personal data. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

8 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your PDFMonkey API key from https://dashboard.pdfmonkey.io/accountRequired

Environment variable: PDFMONKEY_API_KEY

How to Install

Add this to your MCP configuration file:

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

Documentation

View on GitHub

From the project's GitHub README.

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.

npm License: MIT

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.

Reviews

No reviews yet

Be the first to review this server!