# PDFik

> PDFik is a freemium MCP server for files and documents. MCP server that turns web pages, HTML or Markdown into PDFs, screenshots and Factur-X. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Website:** https://docs.pdfik.net/integrations/mcp
- **Repository:** https://github.com/pdfik/pdfik-mcp
- **MCP Registry name:** io.github.pdfik/pdfik-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-20

## About

The README describes this as a local server that runs on your computer, calls the PDFik API with your key and saves rendered files to a folder on disk, so the assistant only receives the file path. Rendering covers public URLs, raw HTML and Markdown, with PNG or JPEG captures of pages and HTML. A separate tool builds Factur-X / ZUGFeRD PDF/A-3 files from CII invoice XML.

The package installs through npm as @pdfik/mcp and also ships as an .mcpb bundle for Claude Desktop. Setup needs Node.js 22 or newer and a PDFik API key. Test mode produces free jobs with sample output, which helps when trying the tools before spending quota.

It suits people who work with an AI assistant in Claude, Cursor or similar clients and want documents produced from that chat, especially invoice-related workflows in the Factur-X format.

## Features

- **URL and HTML rendering:** Converts a public web page or HTML markup into a PDF with paper size, margins, header, footer and watermark options.
- **Markdown to PDF:** Renders CommonMark and GFM tables into a PDF document.
- **Page screenshots:** Captures web pages or HTML as PNG or JPEG images.
- **Factur-X e-invoices:** Builds PDF/A-3 e-invoices from CII invoice XML, and can add one when converting a URL.
- **Local file saving:** Writes outputs to a chosen folder without overwriting existing files, and the assistant gets the path.
- **Job control and quota check:** Supports deferred renders with job status and download tools, plus a tool to check plan and usage.

## Good for

- Save a web page as a PDF from an AI assistant chat
- Convert Markdown notes into a formatted PDF
- Create Factur-X e-invoices from CII XML
- Capture screenshots of pages at a set size
- Check remaining PDFik quota before running batch jobs

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdfik-mcp --env PDFIK_API_KEY='<PDFIK_API_KEY>' -- npx -y @pdfik/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pdfik-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pdfik/mcp"
      ],
      "env": {
        "PDFIK_API_KEY": "<PDFIK_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdfik-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pdfik/mcp"
      ],
      "env": {
        "PDFIK_API_KEY": "<PDFIK_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pdfik-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pdfik/mcp"
      ],
      "env": {
        "PDFIK_API_KEY": "<PDFIK_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdfik-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pdfik/mcp"
      ],
      "env": {
        "PDFIK_API_KEY": "<PDFIK_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdfik-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pdfik/mcp"
      ],
      "env": {
        "PDFIK_API_KEY": "<PDFIK_API_KEY>"
      }
    }
  }
}
```

## Tools

- `url_to_pdf`: Renders a public web page to PDF with layout options and optional Factur-X e-invoice.
- `html_to_pdf`: Renders sanitized HTML markup up to 512 KiB to PDF.
- `markdown_to_pdf`: Renders Markdown with CommonMark and GFM tables to PDF.
- `url_to_image`: Captures a web page as PNG or JPEG.
- `html_to_image`: Captures HTML markup as PNG or JPEG.
- `einvoice_to_pdf`: Builds a Factur-X / ZUGFeRD PDF/A-3 from CII invoice XML.
- `get_job`: Returns the status of a job.
- `download_job`: Saves the output of a finished job, up to 3 downloads within 24 hours.
- `get_account`: Returns plan, quota, usage and limits without creating anything.

## FAQ

### Does the API key pass through the assistant?

The README and docs say the key is read from the server's environment and is never a tool argument or part of a tool result.

### Where are the generated files stored?

Files are saved to the output folder, by default ~/Downloads/PDFik, and the README says generated files are kept on PDFik's side for 24 hours.

### Is there a free way to try PDFik?

Setting PDFIK_TEST_MODE to 1 makes every job a free test job with sample output, and the README says every PDFik plan, including Free, can use the server.

### What license is the server under?

The repository and docs state MIT.

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

Run this command in your terminal: claude mcp add pdfik-mcp --env PDFIK_API_KEY='<PDFIK_API_KEY>' -- npx -y @pdfik/mcp

### What are the best alternatives to PDFik?

The closest alternatives to PDFik are TemplateFoxPDF, PDFDispatch, FynePDF, html2pdfconverter and PolyDoc.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TemplateFoxPDF](https://ai-powered.com/mcp/templatefoxpdf): TemplateFoxPDF is an open-source MCP server for files and documents.
- [PDFDispatch](https://ai-powered.com/mcp/pdfdispatch): PDFDispatch is a freemium MCP server for files and documents.
- [FynePDF](https://ai-powered.com/mcp/fynepdf): FynePDF is a freemium MCP server for files and documents.
- [html2pdfconverter](https://ai-powered.com/mcp/html2pdfconverter): html2pdfconverter is an MCP server for files and documents.
- [PolyDoc](https://ai-powered.com/mcp/polydoc): PolyDoc is a freemium MCP server for files and documents.
- [pdf-to-einvoice](https://ai-powered.com/mcp/pdf-to-einvoice): pdf-to-einvoice is an open-source MCP server for files and documents.
- [pdf.net](https://ai-powered.com/mcp/pdf-net): pdf.net is a free MCP server for files and documents.
- [PDF Generator](https://ai-powered.com/mcp/pdf-generator): PDF Generator is an open-source MCP server for files and documents.

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