Foliopdf Mcp

FolioPDF MCP Server

[](https://github.com/foliopdf/foliopdf-mcp/actions/workflows/ci.yml) [](https://github.com/foliopdf/foliopdf-mcp/releases/latest) [](LICENSE)

PDF generation, manipulation, and extraction for AI agents. Single binary, renders locally, works offline.

Install

Homebrew

brew install foliopdf/tap/foliopdf-mcp

Go

go install github.com/foliopdf/foliopdf-mcp@latest

Direct download

# macOS (Apple Silicon)
curl -L https://github.com/foliopdf/foliopdf-mcp/releases/latest/download/foliopdf-mcp-darwin-arm64.tar.gz | tar xz
sudo mv foliopdf-mcp /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/foliopdf/foliopdf-mcp/releases/latest/download/foliopdf-mcp-darwin-amd64.tar.gz | tar xz
sudo mv foliopdf-mcp /usr/local/bin/

# Linux
curl -L https://github.com/foliopdf/foliopdf-mcp/releases/latest/download/foliopdf-mcp-linux-amd64.tar.gz | tar xz
sudo mv foliopdf-mcp /usr/local/bin/

Setup

Add to Claude Desktop (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "foliopdf": {
      "command": "foliopdf-mcp"
    }
  }
}

Restart Claude Desktop. Ask it to generate a PDF.

Tools

| Tool | What it does | |------|-------------| | render_html | HTML to PDF with Tailwind CSS v3, headers/footers, template variables | | render_markdown | Markdown to PDF with themes and syntax highlighting | | manipulate_pdf | Merge, split, or rotate PDFs | | extract_pdf | Extract text and metadata from a PDF |

Every response includes the PDF as base64 data and a local file path.

Features

Tailwind CSS v3

Set tailwind: true. The full stylesheet is bundled in the binary — works offline.

{"html": "Hello", "tailwind": true}

Tailwind v4 is not supported.

Bundled fonts

Inter and Geist are embedded in the binary. Use them in CSS without any setup:

body { font-family: 'Inter', sans-serif; }
h1 { font-family: 'Geist', sans-serif; }

Both include Regular, Bold, Italic, and Bold Italic weights.

Template variables

Go html/template syntax in both HTML and Markdown:

{
  "html": "Invoice for {{.company}}Amount: {{.amount}}",
  "data": {"company": "Acme Corp", "amount": "$1,234"}
}

Supports {{.variable}}, {{range .items}}...{{end}}, {{if .condition}}...{{end}}.

Headers and footers

Repeating content on every page. Use ` and ` for page numbers.

{
  "header_html": "{{.company}}",
  "footer_html": "Page  of "
}

Markdown themes

Three built-in themes for render_markdown:

• github — clean sans-serif, colored links, code backgrounds
• minimal — serif typography, maximum readability
• print — formal layout, justified text, optimized for printing

Watermarks

Diagonal text overlay on every page:

{"watermark": "DRAFT"}

Development

go build ./...
go test ./...
./foliopdf-mcp --version

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: foliopdf
• Source: foliopdf/foliopdf-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.