PDF Tools MCP

PDF Tools MCP

Comprehensive PDF manipulation via MCP protocol.

31
Stars
8
Forks
31
Watchers
3
Issues
PDF Tools MCP provides an extensive suite of PDF manipulation operations using the Model Context Protocol framework. It supports both local and remote PDF tasks, such as rendering pages, merging, extracting metadata, retrieving text, and combining documents. The tool registers endpoints through the MCP protocol, enabling seamless server-based PDF processing for various clients. Built with Python, it emphasizes secure handling and compatibility with Claude Desktop via the Smithery ecosystem.

Key Features

Render PDF pages as images
Merge multiple PDF pages into a single long page
Extract document metadata
Extract detailed text blocks and information
Create freeform or full-width PDF snippets
Combine pages from multiple documents
Fetch and store remote PDFs
Async operations with aiohttp and aiofiles
Security-focused file storage using UUID4 filenames
Endpoints registered through Model Context Protocol

Use Cases

Viewing PDFs as images within AI interfaces
Combining pages from several documents into one
Extracting metadata for document cataloging
Text extraction for search and summarization
Selective snippet creation for collaboration or annotation
Downloading and storing online PDFs for local processing
Merging reports or forms for streamlined workflows
Integrating PDF functionality with AI assistants like Claude Desktop
Automating document handling in backend services
Securely processing sensitive PDFs for digital assistance

README

PDF Tools MCP

smithery badge

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:

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

Manual Installation

bash
# 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:

bash
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
bash
# 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.

Star History

Star History Chart

Repository Owner

Repository Details

Language Python
Default Branch master
Size 1,174 KB
Contributors 3
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
97.35%
Dockerfile
2.65%

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Coda MCP Server

    Coda MCP Server

    A Model Context Protocol server enabling seamless interaction with Coda documents and pages.

    Coda MCP Server implements a Model Context Protocol (MCP) server that bridges AI assistants or MCP clients with the Coda API. It provides standardized tools for listing, creating, reading, updating, duplicating, and renaming Coda pages, as well as handling document context. The server communicates over standard input/output, supporting integration with platforms like Cursor and Claude Desktop, and can be deployed via Node.js or Docker.

    • 36
    • MCP
    • orellazri/coda-mcp
  • anki-mcp

    anki-mcp

    MCP server for seamless integration with Anki via AnkiConnect.

    An MCP server that bridges Anki flashcards with the Model Context Protocol, exposing AnkiConnect functionalities as standardized MCP tools. It organizes Anki actions into intuitive services covering decks, notes, cards, and models for easy access and automation. Designed for integration with AI assistants and other MCP-compatible clients, it enables operations like creating, modifying, and organizing flashcards through a unified protocol.

    • 6
    • MCP
    • ujisati/anki-mcp
  • MCP Obsidian Server

    MCP Obsidian Server

    Integrate Obsidian note management with AI models via the Model Context Protocol.

    MCP Obsidian Server acts as a bridge between Obsidian and AI models by providing an MCP-compatible server interface. It enables programmatic access to Obsidian vaults through a local REST API, allowing operations like listing files, searching, reading, editing, and deleting notes. Designed to work with Claude Desktop and other MCP-enabled clients, it exposes a set of tools for efficient note and content management within Obsidian.

    • 2,394
    • MCP
    • MarkusPfundstein/mcp-obsidian
  • MyMCP Server (All-in-One Model Context Protocol)

    MyMCP Server (All-in-One Model Context Protocol)

    Powerful and extensible Model Context Protocol server with developer and productivity integrations.

    MyMCP Server is a robust Model Context Protocol (MCP) server implementation that integrates with services like GitLab, Jira, Confluence, YouTube, Google Workspace, and more. It provides AI-powered search, contextual tool execution, and workflow automation for development and productivity tasks. The system supports extensive configuration and enables selective activation of grouped toolsets for various environments. Installation and deployment are streamlined, with both automated and manual setup options available.

    • 93
    • MCP
    • nguyenvanduocit/all-in-one-model-context-protocol
  • MCP Server for Odoo

    MCP Server for Odoo

    Connect AI assistants to Odoo ERP systems using the Model Context Protocol.

    MCP Server for Odoo enables AI assistants such as Claude to interact seamlessly with Odoo ERP systems via the Model Context Protocol (MCP). It provides endpoints for searching, creating, updating, and deleting Odoo records using natural language while respecting access controls and security. The server supports integration with any Odoo instance, includes smart features like pagination and LLM-optimized output, and offers both demo and production-ready modes.

    • 101
    • MCP
    • ivnvxd/mcp-server-odoo
  • TickTick MCP Server

    TickTick MCP Server

    Enable powerful AI-driven task management for TickTick via the Model Context Protocol.

    TickTick MCP Server provides comprehensive programmatic access to TickTick task management features using the Model Context Protocol. Built on the ticktick-py library, it enables AI assistants and MCP-compatible applications to create, update, retrieve, and filter tasks with improved precision and flexibility. The server supports advanced filtering, project and tag management, subtask handling, and robust context management for seamless AI integration.

    • 35
    • MCP
    • jen6/ticktick-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results