Read tool: pdftoppm not found despite being installed (PATH not inherited)
Resolved 💬 3 comments Opened Apr 2, 2026 by arthur-bamboo Closed Apr 5, 2026
Description
The Read tool fails to render PDF pages with the error:
pdftoppm is not installed. Install poppler-utils (e.g.brew install popplerorapt-get install poppler-utils) to enable PDF page rendering.
However, pdftoppm is installed and works correctly from the Bash tool and the user's shell.
Environment
- macOS (Darwin 24.6.0)
- Claude Code CLI
- poppler 26.03.0 installed via Homebrew
pdftoppmlocated at/usr/local/bin/pdftoppm(symlink to../Cellar/poppler/26.03.0/bin/pdftoppm)/usr/local/binis in the shell PATH
Steps to Reproduce
- Install poppler:
brew install poppler - Confirm
which pdftoppmreturns/usr/local/bin/pdftoppm - Use the Read tool on any PDF with
pagesparameter - Read tool returns "pdftoppm is not installed" error
- Use Bash tool to run
pdftoppm— works fine
Root Cause (suspected)
The Read tool's internal process uses a minimal/stripped PATH that doesn't include /usr/local/bin (standard Homebrew prefix on Intel Macs) or /opt/homebrew/bin (Apple Silicon). It likely only searches /usr/bin, /bin, etc.
Expected Behavior
The Read tool should find pdftoppm when it's installed in standard Homebrew locations (/usr/local/bin, /opt/homebrew/bin).
Workaround
Use Bash to run pdftoppm or pdftotext directly.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗