How to add PDF Reader MCP to Cursor
Extract text, images, and metadata from local or URL PDFs as structured output, dir-confined. Paste the config into ~/.cursor/mcp.json and restart Cursor.
Last updated June 15, 2026 · 200★ · stdio · no auth
Cursor config for PDF Reader MCP
npx -y @sylphx/pdf-reader-mcp{
"mcpServers": {
"pdf-reader-mcp": {
"command": "npx",
"args": [
"-y",
"@sylphx/pdf-reader-mcp"
]
}
}
}Setup steps
- 1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
- 2Paste the PDF Reader MCP config below into the "mcpServers" object.
- 3Fill in placeholder secrets, then save.
- 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
- 5Ask Cursor to use one of PDF Reader MCP's tools to confirm it's connected.
Before you start
- Node.js 22.13.0 or higher (required by pdfjs-dist v6)
- npx (bundled with Node.js) to run @sylphx/pdf-reader-mcp without a global install
- No credentials or API key needed — auth is none
- Optional: a directory to confine reads to (passed via --allow-dir), and network access if reading PDFs from URLs
What PDF Reader MCP can do in Cursor
read_pdfUnified tool to extract text, images, metadata, and page count from one or more PDF sources (local paths or URLs), with optional per-source page-range selection.
Security
File access is confined to the working directory the host sets, so run it with the cwd scoped to the intended project folder. Parsing untrusted PDFs always carries some parser-exploitation risk; only process documents you trust. Note: use the current @sylphx/ package, not the older @sylphlab/ name.
PDF Reader MCP + Cursor FAQ
Where is the Cursor config file?
Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the PDF Reader MCP config there under the "mcpServers" key and restart the client.
Is PDF Reader MCP safe to use with Cursor?
File access is confined to the working directory the host sets, so run it with the cwd scoped to the intended project folder. Parsing untrusted PDFs always carries some parser-exploitation risk; only process documents you trust. Note: use the current @sylphx/ package, not the older @sylphlab/ name.
Does it need an API key or authentication?
No. It runs locally over stdio with no auth, reading PDFs from the filesystem or from HTTP/HTTPS URLs you allow.
Can it read PDFs from a URL, not just local files?
Yes. Each source can specify a `url` field for HTTP/HTTPS PDFs. You can disable this with `--no-http` or restrict it to specific domains with `--allow-host`.
How do I restrict which directories it can read?
Pass `--allow-dir=/path` (repeatable) or set the `MCP_PDF_ALLOWED_DIRS` environment variable. Reads outside allowed directories fail fast with an Access denied error.