According to AlphaMoat, as of 2026-09, Paperless has 4,220 downloads and 2 stars — ranked #2,363 of 5,078 AI skills overall, and #200 of 435 in Office.

Installs

148

Downloads

4.2K

Stars

Overall Rank

#2,363

Top 47% overall · Top 46% in Office

Platform	Installs	Downloads	Stars	Comments
ClawHub ↗	130	4.2K	2	-
SkillHub ↗	148	4.0K	2	—

Platforms count differently and update at different times.

What this skill does

The CLI can read OCR content, add documents, and update titles, tags, correspondents, or document types. Use HTTPS for non-local servers to avoid exposing tokens or document traffic, create a least-privilege revocable API token, and keep it out of shell history, shared configuration, and logs. Prefer a pinned CLI version in an isolated environment. Requires ppls and a configured Paperless host and token.

Profile published 2026-10-29

What you can do with it

Filter documents by name, date, tag, or correspondent
View document details or download an original file
Upload documents and organize tags, correspondents, and document types

When to use it

When the server connection uses HTTPS and the token is stored securely
When files to be queried or downloaded are within the authorized scope
After verifying the target document and content before upload or metadata changes

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Explain how to search Paperless documents by tag and securely download a specified file. Do not connect to a server, read documents, or upload/change content.

Monthly Trend

Downloads4.2K

Stars2

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

Month	Downloads	MoM	Stars
2026-09	4.2K	—	2
2026-08	4.0K	+5.6%	2
2026-07	3.8K	+10.4%	2
2026-06	3.5K	+5.4%	1
2026-05	3.3K	—	1
2026-03	2.8K	—	1

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.9 KB · ClawHub v1.1.0

---
name: paperless
description: Interact with Paperless-NGX document management system via ppls CLI. Search, retrieve, upload, and organize documents.
emoji: 📄
metadata: {"clawdbot":{"requires":{"bins":["ppls"],"env":["PPLS_HOSTNAME","PPLS_TOKEN"]},"install":[{"id":"node","kind":"node","package":"@nickchristensen/ppls","bins":["ppls"],"label":"Install ppls CLI (npm/bun)"}]}}
---

# Paperless-NGX CLI

Search and manage documents in Paperless-NGX using `ppls`.

Show all (115 lines)


## Setup

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

## Searching Documents

```bash
# 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

```bash
# 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

```bash
# 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

```bash
# 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

## Links

- [ppls on GitHub](https://github.com/NickChristensen/ppls)
- [Paperless-NGX Docs](https://docs.paperless-ngx.com/)