# PDF Writer (PDF Agent Stack)

> PDF Writer (PDF Agent Stack) is an open-source MCP server for files and documents. Create and edit PDFs from text, Markdown and tables, with Japanese font embedding. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://shuji-bonji.github.io/pdf-agent-stack/
- **Repository:** https://github.com/shuji-bonji/pdf-writer-mcp
- **MCP Registry name:** io.github.shuji-bonji/pdf-writer-mcp
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

Built on a clause-driven PDF library tied to ISO 32000, this server writes PDFs and edits existing ones. Creation tools cover plain text, Markdown with headings, lists, code blocks and tables, and ruled tables with automatic column widths and repeated headers. Options include page size from A3 to Letter, margins, fonts, metadata, a base64 return and a PDF version.

It can write PDF 2.0 files, and passing a tagged option produces accessible PDF/UA output that the README reports as passing all 106 veraPDF rules for PDF/UA-1. CJK fonts are embedded through harfbuzz subsetting.

All file paths must be absolute, and input PDFs over 100 MB are rejected. It is one of four servers in a PDF family: a reader for structure, a verifier for signatures and conformance, a specification server, and this writer. The site describes 20 editing tools such as merge, split, annotations and metadata.

## Features

- **Text to PDF:** create_text_pdf wraps lines and treats blank lines as paragraph breaks.
- **Markdown to PDF:** create_markdown_pdf handles headings, lists, code blocks, quotes, rules and tables.
- **Ruled tables:** create_table_pdf sets column widths and repeats headers across pages.
- **Tagged accessible output:** Produces PDF/UA-tagged files for accessibility.
- **PDF 2.0 output:** Optionally writes ISO 32000-2 files.
- **CJK font embedding:** Embeds Japanese and other CJK fonts through subsetting.
- **Page and metadata edits:** Merge, split, annotate and edit metadata of existing PDFs.

## Good for

- Turn an agent's Markdown report into a PDF
- Generate a table-based document with repeating headers
- Produce accessible PDFs for compliance
- Merge or split existing PDFs
- Create Japanese-language documents

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdf-writer-mcp -- npx -y @shuji-bonji/pdf-writer-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pdf-writer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-writer-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-writer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-writer-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pdf-writer-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-writer-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-writer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-writer-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-writer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-writer-mcp"
      ]
    }
  }
}
```

## Tools

- `create_text_pdf`: Create a PDF from plain text
- `create_markdown_pdf`: Create a PDF from Markdown
- `create_table_pdf`: Create a PDF with ruled tables

## FAQ

### Can I use relative paths?

No. Since v0.7.0 relative paths and paths containing .. are rejected.

### Is there a size limit?

Input PDFs larger than 100 MB are rejected.

### Does it support accessibility tagging?

Yes, with tagged: true it produces PDF/UA output, and a title is required.

### How is it installed?

As the npm package @shuji-bonji/pdf-writer-mcp, run over stdio.

### Is PDF Writer (PDF Agent Stack) free?

Yes. PDF Writer (PDF Agent Stack) is open source, so you can use and self-host it for free.

### How do I add PDF Writer (PDF Agent Stack) to Claude Code?

Run this command in your terminal: claude mcp add pdf-writer-mcp -- npx -y @shuji-bonji/pdf-writer-mcp

### What are the best alternatives to PDF Writer (PDF Agent Stack)?

The closest alternatives to PDF Writer (PDF Agent Stack) are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/pdf-writer-pdf-agent-stack
