Claude Directory

Back to MCP Servers

Pdf Tools

PDF download, view & manipulation utilities.

other-tools-and-integrations

By danielkennedy1

31 12Updated 1 year agoPythonMIT

Installation

npx -y pdf-tools-mcp

Configuration

{
  "mcpServers": {
    "pdf-tools-mcp": {
      "command": "npx",
      "args": ["-y", "pdf-tools-mcp"]
    }
  }
}

How to use

Run the installation command above (if needed)
Open your Claude Code settings file (~/.claude/settings.json)
Add the configuration to the mcpServers section
Restart Claude Code to apply changes

README

PDF Tools MCP

A comprehensive set of PDF manipulation tools built with the Model Context Protocol (MCP) framework.

Features

Local PDF Operations

Display: Render PDF pages as images
Merge: Combine multiple pages into a single long page
Metadata: Extract document metadata
Text: Extract text blocks and detailed text information
Snippets: Create freeform or full-width snippets from PDF pages
Fuse: Combine pages from multiple documents into a single document

Remote PDF Operations

Display: Render remote PDF pages as images
Download: Fetch PDFs from URLs to local storage

Installation

Installing via Smithery

To install PDF Tools for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @danielkennedy1/pdf-tools-mcp --client claude

Manual Installation

# Clone the repository
git clone https://github.com/yourusername/pdf-tools-mcp.git
cd pdf-tools-mcp

# Install dependencies
uv pip install -e .

Usage

Start the MCP server:

python -m src.main

The server provides PDF manipulation endpoints through the MCP protocol.

Development

Python 3.12+ required
Uses the MCP framework for tool registration
PDF documents are stored with UUID4 filenames for security

# Update dependencies
uv pip install -e . --upgrade

# Commit changes (uses conventional commit format)
cz commit

Dependencies

MCP Framework
PyMuPDF
aiohttp/aiofiles for async operations
python-magic-bin for file type detection

License

MIT. See LICENSE.

View source on GitHub

You might also like