hanweg/mcp-pdf-tools

# MCP PDF Tools Server
An MCP (Model Context Protocol) server that provides PDF manipulation tools. This server allows LLMs to perform operations like merging PDFs and extracting pages through the Model Context Protocol.
## Features
Merge multiple PDF files into a single PDF
Merge multiple PDF files into a single PDF in user specified order
Extract specific pages from a PDF file
Search PDFs filesystem search or Everything search works better than this
Find (and merge) related PDFs based on text extraction and regex pattern matching from a target input PDF
## Installation
1. Clone this repository
2.
bash
cd mcp-pdf-tools
# Create and activate virtual environment
uv venv
.venv\Scripts\activate
# Install the package
uv pip install -e .
## Usage with Claude Desktop
Add this to your Claude Desktop configuration file (claudedesktopconfig.json):
json
"mcpServers": {
"pdf-tools": {
"command": "uv",
"args": [
"--directory",
"PATHTO\\mcp-pdf-tools",
"run",
"pdf-tools"
],
"env": {
"PDFTOOLSALLOWEDDIRS": "PATHTO\\shared\\pdfs"
PDFTOOLSALLOWEDDIRS is an optional path list (use your OS path separator) that restricts file access for all tools. If not set, the server limits access to its current working directory.
Write tools (merge-pdfs, extract-pages, merge-pdfs-ordered) refuse to overwrite an existing output file unless overwrite: true is provided.