PDF Manipulation

by hanweg

29 stars

717 downloads

Not rated

GitHub

About

Integrates PDF manipulation capabilities using Python libraries to enable merging, extraction, and content-based document retrieval tasks.

Details

Author: hanweg
Repository: hanweg/mcp-pdf-tools
GitHub stars: 29
Downloads: 717
License: The Unlicense
Categories: Productivity, Other, File Management, Developer Tools, Design, Workplace, AI, Search, Infrastructure, Frontend, Knowledge Base, Project Management

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name PDF Manipulation

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 --directory
- Argument 2 PATH_TO/mcp-pdf-tools
- Argument 3 run
- Argument 4 pdf-tools
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO\\mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO\\mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO\\mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO\\mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO\\mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

JSON

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

From the repository

1. Clone this repository
2.

cd mcp-pdf-tools uv venv .venv\Scripts\activate

uv pip install -e .

Add this to your Claude Desktop configuration file (claude_desktop_config.json):

{
    "mcpServers": {
        "pdf-tools": {
            "command": "uv",
            "args": [
                "--directory",
                "PATH_TO\\mcp-pdf-tools",
                "run",
                "pdf-tools"
            ]
        }
    }
}

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "pdf manipulation": {
            "cwd": null,
            "env": {},
            "args": [
                "--directory",
                "PATH_TO/mcp-pdf-tools",
                "run",
                "pdf-tools"
            ],
            "shell": false,
            "command": "uv"
        }
    }
}

Linux

{
    "cwd": null,
    "env": [],
    "args": [
        "--directory",
        "PATH_TO/mcp-pdf-tools",
        "run",
        "pdf-tools"
    ],
    "shell": false,
    "command": "uv"
}

Macos

{
    "cwd": null,
    "env": [],
    "args": [
        "--directory",
        "PATH_TO/mcp-pdf-tools",
        "run",
        "pdf-tools"
    ],
    "shell": false,
    "command": "uv"
}

Windows

{
    "cwd": null,
    "env": [],
    "args": [
        "--directory",
        "PATH_TO\\mcp-pdf-tools",
        "run",
        "pdf-tools"
    ],
    "shell": false,
    "command": "uv"
}

WORK IN PROGRESS - USE WITH CAUTION - Windows:

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.

- 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 PDFsfilesystem 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

cd mcp-pdf-tools # Create and activate virtual environment uv venv .venv\Scripts\activate # Install the package uv pip install -e .

Add this to your Claude Desktop configuration file (claude_desktop_config.json):

{ "mcpServers": { "pdf-tools": { "command": "uv", "args": [ "--directory", "PATH_TO\\mcp-pdf-tools", "run", "pdf-tools" ] } } }

Universal document generation and conversion MCP. Generate PDF/DOCX/XLSX from templates+JSON (invoices, contracts, reports), batch generation, 100+ format conversions.

Carryo is a remote MCP server for sharing Claude or ChatGPT-created HTML artifacts as live links.

MCP server that reads and writes the system clipboard — tables, text, code, JSON, URLs, images, and more. Preserves spreadsheet structure (rows/columns) that is lost when pasting into Claude directly. Claude can also write results back to your clipboard.

Generates professional PDF cover letters using LaTeX. Requires Docker for local execution.

A server for reading and converting documents between PDF, DOCX, and Markdown formats using marker-pdf and pandoc.

Read and edit Word (.docx) documents with track changes, comments, footnotes, and structural validation. 18 tools with OOXML-level paraId validation and document auditing.

Search, cite, and read PDFs from your EndNote reference library directly in Claude Desktop

Read and write data from Microsoft Excel files. Supports text, formulas, sheet creation, and Windows-only live editing.

Interact with Google Docs and Google Drive for document creation, editing, and file management, with support for shared drives.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

Linux

Macos

Windows

WORK IN PROGRESS - USE WITH CAUTION - Windows:

Install

More like this

Sequential Thinking

Time

Filesystem

EverArt

Google Drive

Reactive Resume