Install Paperless MCP for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
- Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
- Paste the JSON config below.
- Replace placeholder secrets, then restart the client if it does not reload on its own.
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"pvliesdonk-paperless-mcp": {
"command": "uvx",
"args": [
"pvliesdonk-paperless-mcp"
],
"env": {
"PAPERLESS_MCP_KV_STORE_URL": "file:///data/state",
"PAPERLESS_MCP_TOOLS_ALLOW": "",
"PAPERLESS_MCP_TOOLS_DENY": "",
"PAPERLESS_MCP_SERVER_NAME": "",
"PAPERLESS_MCP_INSTANCE_DESCRIPTION": "",
"PAPERLESS_MCP_INSTRUCTIONS_EXTRA": "",
"PAPERLESS_MCP_INSTRUCTIONS": "",
"PAPERLESS_MCP_LOG_LEVEL": "INFO",
"PAPERLESS_MCP_LOG_FORMAT": "",
"PAPERLESS_MCP_PAPERLESS_URL": "",
"PAPERLESS_MCP_API_TOKEN": "YOUR_PAPERLESS_MCP_API_TOKEN",
"PAPERLESS_MCP_HTTP_TIMEOUT_SECONDS": "30.0",
"PAPERLESS_MCP_HTTP_RETRIES": "2",
"PAPERLESS_MCP_DEFAULT_PAGE_SIZE": "25",
"PAPERLESS_MCP_PAPERLESS_PUBLIC_URL": "",
"PAPERLESS_MCP_TRANSFER_TTL_DEFAULT_S": "3600.0",
"PAPERLESS_MCP_TRANSFER_TTL_MAX_S": "86400.0",
"PAPERLESS_MCP_TRANSFER_GRACE_TTL_S": "60.0",
"PAPERLESS_MCP_TRANSFER_LEASE_S": "60.0",
"PAPERLESS_MCP_TRANSFER_MAX_UPLOAD_BYTES": "104857600"
}
}
}
}