An AI-native command-line interface for Paperless-ngx. Designed for both human operators and AI agents.
-F id,title) to reduce output sizepngx mcp) for tool-calling agents--json-errors) with machine-readable codescargo install --git https://github.com/lukasmalkmus/pngx
Download a prebuilt binary from the releases page.
Configure your Paperless-ngx instance:
pngx auth login
Verify the connection:
pngx auth status
Search for documents:
pngx search "invoice 2024"
pngx ships as a Claude Code plugin
with a paperless skill for document search workflows.
# Add the pngx marketplace
claude plugin marketplace add lukasmalkmus/pngx
# Install the plugin
claude plugin install pngx@pngx
Once installed, the skill activates automatically when your prompt mentions Paperless-ngx documents:
Find all invoices from January 2025 in Paperless
You can also invoke it explicitly with /paperless.
pngx [--url URL] [--token TOKEN] [-v...] COMMAND
| Command | Description |
|---|---|
auth login | Save server URL and API token |
auth logout | Remove saved credentials |
auth status | Show config and verify connection |
inbox | List inbox documents |
search QUERY | Search documents |
documents list | List all documents |
documents get ID... | View document details |
documents content ID... | Show text content |
documents open ID... | Open in the web UI |
documents download ID... | Download document files |
tags | List all tags |
correspondents | List all correspondents |
document-types | List all document types |
mcp | Start MCP server over stdio |
version | Show CLI and server version |
inbox, search, and documents list default to 25 results. Use -n to limit,
-n 0 for unlimited, or --all to fetch everything. Metadata commands always
show all items.
Use --url and --token to override credentials per-call. Commands that
produce formatted output accept -o markdown (default), -o json, or -o ndjson.
Use -F / --fields to select specific fields (e.g., -F id,title).
Use --json-errors (or PNGX_JSON_ERRORS=1) to get structured error output
on stderr with machine-readable error codes.
For tool-calling agents, start the MCP server:
{
"mcpServers": {
"pngx": {
"command": "pngx",
"args": ["mcp"],
"env": {
"PNGX_URL": "https://paperless.example.com",
"PNGX_TOKEN": "your-api-token"
}
}
}
}
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Server or deserialization error |
| 2 | Usage error or unauthorized |
| 3 | Not found |
| 4 | I/O, network, timeout, or URL error |
| 5 | Configuration error |
pngx auth login writes credentials to ~/.config/pngx/config.toml.
Alternatively, set environment variables:
export PNGX_URL=https://paperless.example.com
export PNGX_TOKEN=your-api-token
Precedence: flags > environment variables > config file.
MIT - see LICENSE for details.
Admin access level
Server config contains admin-level keywords
Executes bash commands
Hook triggers when Bash tool is used
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub lukasmalkmus/pngx --plugin pngxAgent-native CLI and MCP server for MoneyMoney
Query free one-night camping spots from 1nitetent.com via CLI and MCP
Open source document intelligence and review plugin for Claude Code: ingest, search, review, enrich, and export local document workspaces.
Search your local documents with natural language. Index folders of PDFs, Word docs, markdown, and more — then ask questions in English or German and get answers with source citations.
Claude plugins for PandaDoc - documents, templates, e-signatures, and proposal management
Memory compression system for Claude Code - persist context across sessions
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.