Que pouvez-vous faire avec 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_statuslater with the document ID.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
pdfmonkey-mcp-serverclaude mcp add pdfmonkey -e 'PDFMONKEY_API_KEY=<your pdfmonkey_api_key>' -- npx -y pdfmonkey-mcp-server@1.0.1
{
"mcpServers": {
"pdfmonkey": {
"command": "npx",
"args": [
"-y",
"pdfmonkey-mcp-server@1.0.1"
],
"env": {
"PDFMONKEY_API_KEY": "<your pdfmonkey_api_key>"
}
}
}
}
Variables d'environnement
PDFMONKEY_API_KEYobligatoire secret Your PDFMonkey API key from https://dashboard.pdfmonkey.io/account
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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.
- Runs locally over stdio, with your API key
- Listed in the MCP Registry as
io.github.pdfmonkey/pdfmonkey-mcp - Documentation: pdfmonkey.io/docs/integrations/mcp
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
| Tool | What it does |
|---|---|
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 (polls every 1.5 s, up to 3 minutes) |
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 |
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_statuslater 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.
Questions fréquentes
Qu'est-ce que PDFMonkey ?
Generate PDFs from templates using the PDFMonkey API
Comment installer PDFMonkey ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add pdfmonkey -e 'PDFMONKEY_API_KEY=<your pdfmonkey_api_key>' -- npx -y pdfmonkey-mcp-server@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour PDFMonkey ?
Oui. Il attend PDFMONKEY_API_KEY, à renseigner dans sa configuration.
PDFMonkey est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient PDFMonkey ?
Il est publié par pdfmonkey. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.