Skip to content
MCP server

PDF To Text

Extracts PDF text locally, with macOS PDFKit and Vision OCR fallbacks and optional AI…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.7.0
Listing updated
4 days ago

About PDF To Text

PDF To Text is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Extracts PDF text locally, with macOS PDFKit and Vision OCR fallbacks and optional AI retry.

Install

Run in a terminal

claude mcp add pdf-to-text --env PDF_TO_TEXT_MCP_ROOT='<PDF_TO_TEXT_MCP_ROOT>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y @jim-panse/pdf-to-text-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pdf-to-text": {
      "command": "npx",
      "args": [
        "-y",
        "@jim-panse/pdf-to-text-mcp"
      ],
      "env": {
        "PDF_TO_TEXT_MCP_ROOT": "<PDF_TO_TEXT_MCP_ROOT>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdf-to-text": {
      "command": "npx",
      "args": [
        "-y",
        "@jim-panse/pdf-to-text-mcp"
      ],
      "env": {
        "PDF_TO_TEXT_MCP_ROOT": "<PDF_TO_TEXT_MCP_ROOT>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "pdf-to-text": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jim-panse/pdf-to-text-mcp"
      ],
      "env": {
        "PDF_TO_TEXT_MCP_ROOT": "<PDF_TO_TEXT_MCP_ROOT>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdf-to-text": {
      "command": "npx",
      "args": [
        "-y",
        "@jim-panse/pdf-to-text-mcp"
      ],
      "env": {
        "PDF_TO_TEXT_MCP_ROOT": "<PDF_TO_TEXT_MCP_ROOT>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pdf-to-text": {
      "command": "npx",
      "args": [
        "-y",
        "@jim-panse/pdf-to-text-mcp"
      ],
      "env": {
        "PDF_TO_TEXT_MCP_ROOT": "<PDF_TO_TEXT_MCP_ROOT>",
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}

Configuration

  • PDF_TO_TEXT_MCP_ROOTRequired existing directory that defines the root-relative filesystem namespace for PDF input and derived text output.Required
  • OPENAI_API_KEYOptional secret. Enables one AI extraction retry when local extraction is inadequate; omit for local-only operation.
  • OPENAI_MODELOptional OpenAI model used only for AI retry. Defaults to gpt-5.4-mini.
  • AI_MAX_OUTPUT_TOKENSOptional cap for all AI-generated output tokens, including non-visible reasoning tokens. Integer minimum 800; defaults to 32000.
  • MAX_PARALLEL_EXTRACTIONSInteger concurrency limit from 1 to 32. Defaults to min(os.availableParallelism(), 4).
  • EXTRACTION_QUEUE_CAPACITYInteger maximum waiting requests from 0 to 100; zero disables waiting.
  • EXTRACTION_QUEUE_WAIT_MSMaximum queue wait in milliseconds, integer 1 through 2147483647. Does not limit active work.
  • WRITE_TEXTOptionally save successful extraction text beside the source PDF.

Pricing

Open source

PDF To Text FAQ

Is PDF To Text free?

Yes. PDF To Text is open source, so you can use and self-host it for free.

How do I add PDF To Text to Claude Code?

Run this command in your terminal: claude mcp add pdf-to-text --env PDF_TO_TEXT_MCP_ROOT='<PDF_TO_TEXT_MCP_ROOT>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y @jim-panse/pdf-to-text-mcp

What are the best alternatives to PDF To Text?

The closest alternatives to PDF To Text are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to PDF To Text

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media