Paperless

Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.

Join 0+ developers using this skill

skill

Productivity & Organization

intermediate

0 installs

View Source

Last updated: April 23, 2026

AI Skill Market Insights

Real data. Real impact.

Popularity

Rising

Emerging

Active Users

Developers

Quick Start

Manual Installation

No automatic installation available. Please visit the source repository for installation instructions.

View Installation Instructions

TEAR & SHARE

3-5hrs/WK

RISING

0.0K+ USING

Paperless-NGX CLI

Search and manage documents in Paperless-NGX using

ppls

Setup

npm install -g @nickchristensen/ppls
ppls config set hostname http://your-paperless-host
ppls config set token your-api-token

Searching Documents

# 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

Viewing & Downloading

# 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

Uploading Documents

# 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

Managing Metadata

# 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

Tips

Always use
--json
for AI/automation — it's the most parseable format
Date formats:
```
YYYY-MM-DD
```
or full ISO 8601
IDs are numeric — use
```
list --json
```
commands to find them
Filters are repeatable:
```
--tag 1 --tag 2
```
or
```
--tag 1,2
```
both work
Pagination: Use
```
--page
```
and
```
--page-size
```
for large result sets

Paperless

AI Skill Market Insights

Quick Start

Manual Installation

TEAR & SHARE

Tags

writing-plans

Be Part of the 0+ Developer Community

Paperless-NGX CLI

Setup

Searching Documents

By date range

By tag (OR — any of these tags)

By tag (AND — must have all)

Exclude tags

By correspondent

By document type

Documents missing metadata

Recently added/modified

Combine filters

Viewing & Downloading

Download single document

Download multiple documents

Download original (pre-processed) version

Uploading Documents

With metadata

Managing Metadata

Create new

Update document metadata

Tips

Links

executing-plans

Orca CLI (worktrees & contexts)

find-skills (Vercel)

i-have-adhd (ADHD-friendly output)

Channels

Learn

Compare

Company

Agents