PDF Modifier MCP

CLI + MCP server + Web UI for PDF text replacement with font style preservation.

Quick start

Terminal

pip install pdf-modifier-mcp

# CLI
pdf-mod modify input.pdf output.pdf -r "Draft=Final"

# MCP server (for Claude/Cursor/Codex)
claude mcp add -s user pdf-modifier -- uvx pdf-modifier-mcp

Interfaces

Interface	Description	Run
CLI	`pdf-mod` — batch jobs, scripting, CI pipelines	`make run cli ARGS="..."`
MCP Server	`pdf-modifier-mcp` — AI agents edit PDFs	`make run mcp`
Web UI	FastAPI + SvelteKit — drag & drop, preview, replace	`make up` (Docker) or `make run api` + `make run frontend`

Features

Text replacement — find and replace with font style preservation (family, weight, size, color)
Regex support — pattern-based bulk replacements (--regex)
Hyperlinks — create clickable links or neutralize existing ones
Batch processing — apply same replacements to multiple files
Web UI — drag & drop PDF upload, structure browser, page preview with zoom, text highlighting
MCP tools — read_pdf_structure, inspect_pdf_fonts, list_pdf_hyperlinks, modify_pdf_content

Development

bash

# Setup
make setup

# Run tests
make test

# Full check (lint + type + test)
make check

# Start dev stack (Docker)
make up
# API: http://localhost:8000 | Web: http://localhost:8080

# Start servers locally
make run api          # FastAPI dev server
make run frontend     # SvelteKit dev server

Documentation

License

MIT