# pdf-table-pull-lite

> pdf-table-pull-lite is an open-source MCP server for files and documents. Pull tables out of text PDFs into one CSV each, locally, with no upload. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://tidybytetools.github.io/tools/pdf-table-pull/
- **Repository:** https://github.com/tidybytetools/pdf-table-pull-lite
- **MCP Registry name:** io.github.tidybytetools/pdf-table-pull-lite
- **Categories:** files and documents, analytics and data
- **Listing updated:** 2026-11-14

## About

Each table found in a PDF is saved as its own CSV named after its page, written as UTF-8 with a BOM so accented text opens correctly in Excel. A strategy option chooses between ruled borders, tables lined up by spacing, or an automatic try of both, and a page range can limit the search.

The free version is deliberately limited. It does not write Excel or JSON, skips scanned pages and lists them, leaves tables that continue over a page as separate files, does not clean numbers so a value like (40) stays as text, and cannot open password-protected PDFs. Merged cells may land in the wrong column, so the README advises checking the output.

It installs with pip on Python 3.10 or newer, under an MIT licence. The paid version adds Excel, JSON, OCR, joined tables and number cleanup; the cloud version charges $0.003 per page with a table.

## Features

- **One CSV per table:** Files are named by page and table number.
- **Border strategies:** Ruled-line, text-aligned or automatic detection.
- **Page ranges:** Limit extraction to selected pages.
- **Excel-friendly CSV:** UTF-8 with BOM keeps accents readable.
- **Skipped page report:** Image-only pages are named, not silently dropped.

## Good for

- Extract statement tables from a bank or finance PDF
- Feed a report's tables to a spreadsheet or script
- Let an assistant read tabular data from a local PDF
- Pull data tables from a quarterly report

## Install

### Claude Code (Terminal)

```sh
claude mcp add pdf-table-pull-lite -- uvx pdf-table-pull-lite
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pdf-table-pull-lite": {
      "command": "uvx",
      "args": [
        "pdf-table-pull-lite"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-table-pull-lite": {
      "command": "uvx",
      "args": [
        "pdf-table-pull-lite"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pdf-table-pull-lite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pdf-table-pull-lite"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-table-pull-lite": {
      "command": "uvx",
      "args": [
        "pdf-table-pull-lite"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pdf-table-pull-lite": {
      "command": "uvx",
      "args": [
        "pdf-table-pull-lite"
      ]
    }
  }
}
```

## FAQ

### Does it do OCR?

No. Scanned pages are skipped and listed.

### What formats does it write?

CSV only in the free version.

### Are my PDFs uploaded?

No, it runs on your computer.

### What does the paid version add?

Excel and JSON output, OCR, tables joined across pages, number cleanup and password-protected PDFs.

### Is pdf-table-pull-lite free?

Yes. pdf-table-pull-lite is open source, so you can use and self-host it for free.

### How do I add pdf-table-pull-lite to Claude Code?

Run this command in your terminal: claude mcp add pdf-table-pull-lite -- uvx pdf-table-pull-lite

### What are the best alternatives to pdf-table-pull-lite?

The closest alternatives to pdf-table-pull-lite are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/pdf-table-pull-lite
