Lets agents search and read large PDFs or folders with hybrid search, selective page reads, tables and OCR.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add pdf -- uvx pdf-mcp~/.codex/config.toml
[mcp_servers.pdf]
command = "uvx"
args = ["pdf-mcp"]
# codex mcp add pdf -- uvx pdf-mcp~/.cursor/mcp.json
{
"mcpServers": {
"pdf": {
"command": "uvx",
"args": [
"pdf-mcp"
]
}
}
}.vscode/mcp.json
{
"servers": {
"pdf": {
"type": "stdio",
"command": "uvx",
"args": [
"pdf-mcp"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"pdf": {
"command": "uvx",
"args": [
"pdf-mcp"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"pdf": {
"command": "uvx",
"args": [
"pdf-mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"pdf": {
"command": "uvx",
"args": [
"pdf-mcp"
]
}
}
}