PageIndex MCP Claude Code — MCP server: install
This MCP server lets an agent search long PDFs through document structure and reasoning. It works with local and online files.
claude mcp add pageindex-mcp -- npx -y @pageindex/mcpWhat PageIndex MCP does
PageIndex MCP gives an agent a way to work with long PDFs. It builds a hierarchical document tree, then uses reasoning and tree search to locate relevant passages. The approach keeps the document structure and context, without a vector database, chunking, or a fixed Top-K setting.
It supports local and online PDFs, document conversations, and up to 1000 free pages. An API setup needs a PageIndex API key and an MCP configuration using https://api.pageindex.ai/mcp; PageIndex App users can connect through OAuth. Local PDF uploads require Node.js ≥18.0.0, so the local server will not start without that runtime.
In Claude Code, add the server with claude mcp add pageindex-mcp -- npx -y @pageindex/mcp. This uses npx to run the local MCP server and lets the agent work with a PDF available on the machine.
What it helps with
- search a long PDF for a specific requirement
- ask questions about a local PDF
- retrieve related passages from an online file
- trace how a result was found in the document tree
Example prompts for the agent
- Analyze this PDF and find the section about API requirements.
- Compare the conditions in the
PricingandLimitssections of this document. - Find every place where authorization is described in this online PDF and explain how the passages relate.
How to install PageIndex MCP
Platform CLI
claude mcp add pageindex-mcp -- npx -y @pageindex/mcpPlatform CLI
codex mcp add pageindex-mcp -- npx -y @pageindex/mcpConfig file
{
"mcpServers": {
"pageindex-mcp": {
"command": "npx",
"args": [
"-y",
"@pageindex/mcp"
]
}
}
}Config file
{
"servers": {
"pageindex-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@pageindex/mcp"
]
}
}
}Platform CLI
gemini mcp add pageindex-mcp npx -y @pageindex/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about PageIndex MCP
How do I install PageIndex MCP in Claude Code?
Run claude mcp add pageindex-mcp -- npx -y @pageindex/mcp. This adds the MCP server through npx.
What does PageIndex MCP do?
It builds a hierarchical tree for a PDF and helps the agent retrieve information through reasoning and structural search, without a vector database or chunking.
What is required for local PDF uploads?
Local PDF uploads require Node.js ≥18.0.0. The server runs through npx.
