# Pdf Tools Ai MCP

> Pdf Tools Ai MCP is an open-source MCP server for files and documents. MCP server for working with PDF files from AI assistants, from MEOK AI Labs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/csoai-org/pdf-tools-ai-mcp
- **MCP Registry name:** io.github.CSOAI-ORG/pdf-tools-ai-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents)
- **Listing updated:** 2026-11-18

## About

The README says this MCP server is published on PyPI and runs over stdio, so it can be attached to desktop AI clients such as Claude Desktop with a short JSON config entry. Example prompts in the README point to tools for extracting text, counting pages and reading document metadata.

The repository states it is MIT-licensed and free to self-host. The README also describes the vendor's wider MEOK AI Labs ecosystem and EU AI Act compliance services, which are separate from the PDF functionality itself and are offered on a pay-per-job basis with no public price list.

It suits developers and power users who want an assistant to read or inspect PDFs locally through MCP. The README does not list PDF operations beyond the three example tools, so buyers should check the package before relying on other capabilities.

## Features

- **Stdio transport install:** Runs over stdio and is installable with pip or uvx for MCP clients.
- **Text extraction:** The README's example prompts reference an extract_text tool for pulling text from PDFs.
- **Page counting:** A count_pages tool is referenced for finding the number of pages in a document.
- **Metadata retrieval:** A get_metadata tool is referenced for reading document metadata.
- **Open source license:** The repository is MIT-licensed and can be self-hosted free of charge.

## Good for

- Extracting text from a PDF inside an AI assistant conversation
- Checking how many pages a document contains before processing it
- Reading PDF metadata as part of a document workflow
- Adding PDF handling to a Claude Desktop setup via MCP

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdf-tools-ai-mcp -- uvx pdf-tools-ai-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `extract_text`: Extracts text from a PDF file, as referenced in the README examples.
- `count_pages`: Counts the pages in a PDF, as referenced in the README examples.
- `get_metadata`: Retrieves PDF metadata, as referenced in the README examples.

## FAQ

### How do I install the server?

The README gives pip install pdf_tools_ai_mcp, or pip install pdf-tools-ai-mcp, and also shows an npx command via Smithery and a uvx entry for the MCP client config.

### What transport does it use?

The registry entry and README both specify stdio transport.

### Is it free?

The repository is MIT-licensed and the README says it is free to self-host. The README also describes pay-per-job MEOK services separately, with no public price list.

### Which tools does it expose?

The README's examples name extract_text, count_pages and get_metadata. No full tool list is given.

### Is Pdf Tools Ai MCP free?

Yes. Pdf Tools Ai MCP is open source, so you can use and self-host it for free.

### How do I add Pdf Tools Ai MCP to Claude Code?

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

### What are the best alternatives to Pdf Tools Ai MCP?

The closest alternatives to Pdf Tools Ai MCP are Pdf Merge Ai MCP, Pdf Document MCP, Pdf MCP, Markdown Ai MCP and Doc Extract MCP.

## Where this comes from

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

## Alternatives

- [Pdf Merge Ai MCP](https://ai-powered.com/mcp/pdf-merge-ai-mcp): Pdf Merge Ai MCP is an open-source MCP server for files and documents.
- [Pdf Document MCP](https://ai-powered.com/mcp/pdf-document-mcp): Pdf Document MCP is an open-source MCP server for files and documents.
- [Pdf MCP](https://ai-powered.com/mcp/pdf-mcp): Pdf MCP is an open-source MCP server for files and documents.
- [Markdown Ai MCP](https://ai-powered.com/mcp/markdown-ai-mcp): Markdown Ai MCP is an open-source MCP server for files and documents.
- [Doc Extract MCP](https://ai-powered.com/mcp/doc-extract-mcp): Doc Extract MCP is an open-source MCP server for files and documents.
- [Api2Pdf MCP by usefulapi](https://ai-powered.com/mcp/api2pdf-mcp-by-usefulapi): Api2Pdf MCP by usefulapi is a freemium MCP server for files and documents.
- [Docparser MCP by usefulapi](https://ai-powered.com/mcp/docparser-mcp-by-usefulapi): Docparser MCP by usefulapi is a freemium MCP server for files and documents.
- [Doxis AI.dp (Klippa DocHorizon) MCP by usefulapi](https://ai-powered.com/mcp/doxis-ai-dp-klippa-dochorizon-mcp-by-usefulapi): Doxis AI.dp (Klippa DocHorizon) MCP by usefulapi is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/pdf-tools-ai-mcp
