Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"pdf-it": {
"args": [
"-y",
"pdf-it-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
A Model Context Protocol (MCP) server and Claude Code skill that turns markdown into PDFs that look like they were made on purpose. Cover page, table of contents, code blocks that hold across page breaks, page-numbered footer. One command from your Claude session to a file you can send to a client.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'pdf-it-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked pdf-it-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in writing
Define task-specific AI sub-agents in Markdown for any MCP-compatible tool.
URL to LLM-ready markdown — plus per-page category, page_structure, and query-driven highlights.
Fonto documentation for AI tools. Converts DITA XML to Markdown on demand.
AI prompt optimization for 58+ platforms across 7 categories with custom platforms
MCP Security Weekly
Get CVE alerts and security updates for io.github.mrslbt/pdf-it and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A Model Context Protocol (MCP) server and Claude Code skill that turns markdown into PDFs that look like they were made on purpose. Cover page, table of contents, code blocks that hold across page breaks, page-numbered footer. One command from your Claude session to a file you can send to a client.
Fonts ship inside the package, so every PDF looks the same on every machine. Nothing to install, nothing to configure.

Every Claude Code research session ends the same way: a wall of useful markdown and no clean way to turn it into a PDF a person would actually want to read.
Chrome print: takes 30 seconds, output looks like a Word doc. Manual HTML conversion: 10 minutes per document. Pandoc: works but defaults look like a 2008 academic paper. None of it produces an artifact you would send to a client.
pdf-it is one command. The output is designed by default.

npm install -g pdf-it-mcp
Or run on demand with npx pdf-it-mcp.
Edit claude_desktop_config.json:
{
"mcpServers": {
"pdf-it": {
"command": "npx",
"args": ["-y", "pdf-it-mcp"]
}
}
}
claude mcp add pdf-it -- npx -y pdf-it-mcp
Add to ~/.cursor/mcp.json with the same shape as Claude Desktop.
Standard MCP config. Same npx -y pdf-it-mcp command.
In any Claude session connected to the server, ask:
Save this as a PDF
Or any of these phrasings: export as PDF, make a PDF report from this, turn this into a PDF, /pdf. The skill picks up the request and routes it through pdf-it. The output lands in ~/Documents/pdf-it/ by default.
| Tool | Description |
|---|---|
generate_pdf | Convert markdown into a PDF. Accepts a template (research-report or plain), optional title and author for the cover, and an optional output path. |
list_templates | Return the list of available templates with descriptions. |
generate_pdf parameters| Parameter | Required | Description |
|---|---|---|
content | yes | Markdown string to convert |
title | no | Shown on the cover and in the page footer |
author | no | Shown on the cover above the date |
output_path | no | Absolute path for the output. Defaults to ~/Documents/pdf-it/{slug}-{timestamp}.pdf |
template | no | research-report (default) or plain |
| Name | Description |
|---|---|
research-report | Cover page with title, author, and date. Auto-generated table of contents from H1 and H2 headings. Body with proper hierarchy. Footer with title and page number. Best for research, summaries, design docs, reports. |
plain | No cover, no TOC. Dense body content only. Best for short notes and quick exports. |
This package ships with a Claude Code skill at SKILL.md. Trigger phrases the skill responds to:
save this as PDFexport as PDFmake a PDF report from thisturn this into a PDFgenerate a PDF/pdfSee SKILL.md for the full skill spec.
By default PDFs are written to ~/Documents/pdf-it/{slug}-{timestamp}.pdf. Pass output_path to override.
Three families ship