The PDF Analyzer MCP Server gives AI agents the ability to read and analyze PDF documents, enabling document Q&A through natural conversations.
Supports multiple LLM providers: Google Gemini, Anthropic Claude, and OpenAI on their direct APIs, plus Google Vertex AI and Anthropic on Vertex AI for service-account auth. Choose your preferred provider and model during setup.
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/IntelligentElectron/pdf-analyzer/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/IntelligentElectron/pdf-analyzer/main/install.ps1 | iexWhy use the native installer:
- No dependencies — standalone binary, no Node.js required
- Auto-updates — checks for updates on startup
- Signed binaries — macOS binaries are notarized by Apple
| Platform | Install Directory |
|---|---|
| macOS | ~/Library/Application Support/pdf-analyzer/ |
| Linux | ~/.pdf-analyzer/ |
| Windows | %LOCALAPPDATA%\pdf-analyzer\ |
The server checks for updates on startup. To update manually:
pdf-analyzer --updateFor developers who prefer npm:
npm install -g @intelligentelectron/pdf-analyzerOr use with npx (no installation required):
npx @intelligentelectron/pdf-analyzer --helpRequires Node.js 20+.
To update:
npm update -g @intelligentelectron/pdf-analyzerAfter installing, run the interactive setup to choose your provider, model, and enter your API key:
pdf-analyzer --setupYou'll be prompted to choose from:
| Provider | Fast Model | Flagship Model | Get API Key |
|---|---|---|---|
| Google Gemini | Gemini 3 Flash | Gemini 3.1 Pro | Google AI Studio |
| Anthropic Claude | Claude Sonnet 4.6 | Claude Opus 4.7 | Anthropic Console |
| OpenAI GPT | GPT-5.4 Mini | GPT-5.4 | OpenAI Platform |
Claude Opus 4.6 is offered alongside 4.7 as the previous flagship. The Vertex AI providers offer the same Gemini and Claude models, and authenticate with a service account JSON key file instead of an API key.
You can re-run --setup at any time to switch providers or models.
After setup, connect the MCP to your AI agent of choice.
Install Claude Code, then run:
claude mcp add --scope user pdf-analyzer -- pdf-analyzerInstall OpenAI Codex, then run:
codex mcp add pdf-analyzer -- pdf-analyzerOnce connected, ask your AI assistant to analyze any PDF:
- "Analyze /path/to/document.pdf and summarize the key points"
- "What tables are in this PDF? Extract the data from table 2"
- "Compare the findings in sections 3 and 5 of this report"
The server accepts:
- Local file paths:
/Users/name/docs/report.pdf - URLs:
https://example.com/document.pdf
| Platform | Binary |
|---|---|
| macOS (Universal) | pdf-analyzer-darwin-universal |
| Linux (x64) | pdf-analyzer-linux-x64 |
| Linux (ARM64) | pdf-analyzer-linux-arm64 |
| Windows (x64) | pdf-analyzer-windows-x64.exe |
Setting PORT starts the server over Streamable HTTP instead of stdio, serving MCP at /mcp, a direct POST /analyze REST endpoint, and GET /health.
See deploy/README.md for deploying it to Cloud Run, including the provider and auth matrix, the IAM roles each provider needs, and how to reach the private service.
See docs/architecture.md for how the server is put together.
See CONTRIBUTING.md for development guidelines.
Created by Valentino Zegna
This project is hosted on GitHub under the IntelligentElectron organization.
Apache License 2.0 - see LICENSE