PDFMonkey MCP server

PDFMonkey MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with the PDFMonkey API for generating PDFs from templates.

Features

• Template Management: List and inspect PDF templates with detailed information (HTML, CSS, properties)
• Document Generation: Create PDFs with async generation and automatic polling
• Document Management: List, check status, and delete generated documents
• Snippet Support: Access reusable Liquid code snippets
• Workspace Info: View workspace details
• User & Quota Management: Check account quota, plan information, and user details

Quick Start

Option 1: Docker (Recommended)

# Build locally (a published Docker Hub image is not available yet)
docker build -t pdfmonkey-mcp-server:latest .

Configure in Claude Desktop:

macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json

Windows: %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PDFMONKEY_API_KEY=your-api-key-here",
        "pdfmonkey-mcp-server:latest"
      ]
    }
  }
}

See DOCKER-MCP-TOOLKIT.md for Docker MCP Toolkit integration.

Option 2: From npm

npm install -g pdfmonkey-mcp-server

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "pdfmonkey-mcp-server",
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 3: From Source

git clone https://github.com/pdfmonkey/pdfmonkey-mcp
cd pdfmonkey-mcp
npm install
npm run build

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "node",
      "args": ["/absolute/path/to/pdfmonkey-mcp-server/dist/index.js"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Get Your API Key

1. Sign up at dashboard.pdfmonkey.io/register
2. Get your API key from the dashboard

Available Tools (11 total)

Workspace Operations

• listworkspaces** - List all accessible workspaces

Template Operations

• listtemplates** - List all PDF templates
• gettemplate** - Get template details with full HTML, CSS, and properties

Document Operations

• generatedocument** - Generate PDF with async polling (1.5s intervals, 3min timeout)
• getdocumentstatus - Check document status and get download URL
• listdocuments - List documents with filters (status, templateid, page, updated_since)
• deletedocument** - Delete document permanently

Snippet Operations

• listsnippets** - List all Liquid code snippets
• getsnippet** - Get snippet code

User & Quota Operations

• getquota** - Get quota and plan information
• getuserinfo - Get complete account details

Usage Examples

Generate an Invoice

User: Generate a PDF invoice using my invoice template

Claude: I'll help you generate an invoice. First, let me list your templates.
[Uses list_templates tool]
I found your invoice template (ID: abc-123). Now I'll generate the PDF.
[Uses generate_document tool with data]
Your invoice has been generated! Download: https://...

View Template Code

User: Show me the HTML and CSS for template abc-123

Claude: [Uses get_template tool]
Here's the complete template:

### 📝 HTML Template
[Shows full HTML code]

### 🎨 CSS Styles
[Shows full CSS code]

### 📊 Sample Data
[Shows JSON properties]

Check Account Status

User: What's my current quota?

Shortened. The full README is on GitHub.