paperlessInteract with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
Install via ClawdBot CLI:
clawdbot install NickChristensen/paperlessInstall ppls CLI (npm/bun):
Install ppls CLI (npm/bun)Requires:
Search and manage documents in Paperless-NGX using ppls.
npm install -g @nickchristensen/ppls
ppls config set hostname http://your-paperless-host
ppls config set token your-api-token# By name
ppls documents list --name-contains "invoice" --json
# By date range
ppls documents list --created-after 2024-01-01 --created-before 2024-12-31 --json
# By tag (OR — any of these tags)
ppls documents list --tag 5 --tag 12 --json
# By tag (AND — must have all)
ppls documents list --tag-all 5,12 --json
# Exclude tags
ppls documents list --tag-not 3 --json
# By correspondent
ppls documents list --correspondent 7 --json
# By document type
ppls documents list --document-type 2 --json
# Documents missing metadata
ppls documents list --no-correspondent --json
ppls documents list --no-tag --json
# Recently added/modified
ppls documents list --added-after 2024-06-01 --json
ppls documents list --modified-after 2024-06-01 --json
# Combine filters
ppls documents list --correspondent 7 --created-after 2024-01-01 --tag 5 --json# Get full document details (includes OCR content)
ppls documents show 1234 --json
# Download single document
ppls documents download 1234 --output ~/Downloads/doc.pdf
# Download multiple documents
ppls documents download 1234 5678 --output-dir ~/Downloads
# Download original (pre-processed) version
ppls documents download 1234 --original# Simple upload (Paperless auto-processes)
ppls documents add scan.pdf
# With metadata
ppls documents add receipt.pdf \
--title "Store Receipt" \
--correspondent 5 \
--document-type 2 \
--tag 10# List tags/correspondents/document-types
ppls tags list --json
ppls correspondents list --json
ppls document-types list --json
# Create new
ppls tags add "Tax 2024" --color "#ff0000"
ppls correspondents add "New Vendor"
ppls document-types add "Contract"
# Update document metadata
ppls documents update 1234 --title "New Title" --correspondent 5 --tag 10--json for AI/automation — it's the most parseable formatYYYY-MM-DD or full ISO 8601list --json commands to find them--tag 1 --tag 2 or --tag 1,2 both work--page and --page-size for large result setsGenerated Mar 1, 2026
Law firms can use this skill to organize case files, contracts, and correspondence. It enables quick retrieval of documents by client name, date, or tags, streamlining case preparation and compliance audits.
Accounting departments can upload and categorize invoices, receipts, and financial statements. The skill allows filtering by date ranges and tags for tax season preparation, ensuring all documents are easily accessible for audits.
Medical clinics can manage patient records, lab reports, and insurance forms. By tagging documents with patient IDs or visit dates, staff can quickly retrieve histories while maintaining confidentiality and regulatory compliance.
Real estate agencies can store and search property agreements, inspection reports, and client communications. The skill helps track documents by property ID or transaction stage, reducing paperwork and improving client service.
Schools and universities can organize syllabi, research papers, and administrative forms. Teachers can find materials by course or semester, facilitating lesson planning and resource sharing among staff.
Offer a service that integrates Paperless-NGX with existing business software like CRM or ERP systems. This adds value by automating document workflows, reducing manual entry, and improving data accessibility for clients.
Provide consulting to help businesses set up and optimize their Paperless-NGX systems. This includes initial configuration, training staff on using the CLI, and creating custom tagging schemes for efficient document management.
Develop automated scripts that use this skill to batch upload, tag, and organize documents from sources like email or scanners. This saves time for clients in high-volume industries like legal or accounting.
💬 Integration Tip
Always use the --json flag for output to ensure data is easily parseable by other systems, and pre-configure environment variables like PPLS_HOSTNAME for seamless automation.
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Create, search, and manage Bear notes via grizzly CLI.
Track water and sleep with JSON file storage
Notion API for creating and managing pages, databases, and blocks.
Smart ClawdBot documentation access with local search index, cached snippets, and on-demand fetch. Token-efficient and freshness-aware.
Work with Obsidian vaults as a knowledge base. Features: fuzzy/phonetic search across all notes, auto-folder detection for new notes, create/read/edit notes with frontmatter, manage tags and wikilinks. Use when: querying knowledge base, saving notes/documents, editing existing notes by user instructions.