# oxidize-pdf MCP Server

> oxidize-pdf MCP Server is an open-source MCP server for files and documents. PDF generation, parsing, splitting and merging for agents, built on a Rust core. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/bzsanti/oxidize-python
- **MCP Registry name:** io.github.bzsanti/oxidize-pdf-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

This server comes bundled with the oxidize-pdf Python library, which wraps a Rust PDF engine with no C, Java or subprocess dependencies. Installing the mcp extra and running oxidize-mcp starts a stdio server with 12 tools, a few resources and 5 prompts for workflows such as summarization, data extraction and form filling.

It is built for safe local use. All paths must resolve inside a workspace directory, with optional extra allowed paths, and limits cap input size at 100 MB by default, pages at 10,000, JSON output at 10 MB and concurrent creation sessions at 10 for an hour. Oversized or malformed documents are rejected up front.

It covers Linux, macOS and Windows on Python 3.10 or later, and the README gives Claude Desktop and VS Code Copilot configs. The README is candid that bindings are an audited subset and full parity with the core is not claimed.

## Features

- **Rust-backed PDF engine:** No native C or Java dependencies.
- **12 MCP tools:** Generate, parse, split, merge and validate PDFs.
- **Workspace sandbox:** Paths must stay inside the configured folder.
- **Resource caps:** Limits on file size, pages, output and sessions.
- **Guided prompts:** Prompts for summarization, extraction and forms.
- **PDF/A checks:** Structure validation and compliance checks.

## Good for

- Merge or split documents for an assistant
- Extract text and data from a stack of PDFs
- Fill a form PDF through chat
- Validate a file for corruption or PDF/A compliance

## Install

### Claude Code (Terminal)

```sh
claude mcp add oxidize-pdf-mcp -- uvx oxidize-pdf
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "oxidize-pdf-mcp": {
      "command": "uvx",
      "args": [
        "oxidize-pdf"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oxidize-pdf-mcp": {
      "command": "uvx",
      "args": [
        "oxidize-pdf"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oxidize-pdf-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oxidize-pdf"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oxidize-pdf-mcp": {
      "command": "uvx",
      "args": [
        "oxidize-pdf"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oxidize-pdf-mcp": {
      "command": "uvx",
      "args": [
        "oxidize-pdf"
      ]
    }
  }
}
```

## FAQ

### How do I install it?

pip install oxidize-pdf with the mcp extra, then run oxidize-mcp.

### Where can it read files?

Only inside OXIDIZE_WORKSPACE plus any allowed paths.

### What are the size limits?

100 MB per file and 10,000 pages by default.

### Licence?

MIT.

### Is oxidize-pdf MCP Server free?

Yes. oxidize-pdf MCP Server is open source, so you can use and self-host it for free.

### How do I add oxidize-pdf MCP Server to Claude Code?

Run this command in your terminal: claude mcp add oxidize-pdf-mcp -- uvx oxidize-pdf

### What are the best alternatives to oxidize-pdf MCP Server?

The closest alternatives to oxidize-pdf MCP Server are SSRS2, Csv, Google_sheets, Onedrive and Zovo Spreadsheet Compare.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Google_sheets](https://ai-powered.com/mcp/google-sheets-3): Google_sheets is a freemium MCP server for files and documents.
- [Onedrive](https://ai-powered.com/mcp/onedrive): Onedrive is a freemium MCP server for files and documents.
- [Zovo Spreadsheet Compare](https://ai-powered.com/mcp/zovo-spreadsheet-compare): Zovo Spreadsheet Compare is an MCP server for files and documents.
- [Video to Audio Converter MCP](https://ai-powered.com/mcp/video-to-audio-converter-mcp): Video to Audio Converter MCP is a free MCP server for design and media.
- [Google_drive](https://ai-powered.com/mcp/google-drive-5): Google_drive is a freemium MCP server for files and documents.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/oxidize-pdf-mcp-server
