Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Search and manage documents in Paperless-NGX using
pplsnpm 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" --jsonBy 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 --jsonDownload 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.pdfWith 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 --jsonCreate 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
--jsonYYYY-MM-DDlist --json--tag 1 --tag 2--tag 1,2--page--page-sizeNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.