Paperless

ReviewAudited by ClawScan on May 1, 2026.

Overview

This is a coherent Paperless-NGX helper, but it needs a Paperless API token and can read, download, upload, and edit document metadata, so users should treat it as having access to their document library.

Before installing, make sure you trust the ppls CLI package and are comfortable giving it a Paperless API token. Use the least-privileged token available, keep searches narrow, and confirm any upload or metadata update before letting the assistant run it.

Findings (4)

Artifact-based informational review of SKILL.md, metadata, install specs, static scan signals, and capability signals. ClawScan does not execute the skill or run runtime probes.

What this means

Anyone using this skill is authorizing access to documents and metadata available to that Paperless token.

Why it was flagged

The skill requires a Paperless hostname and API token, which is expected for the integration but gives the CLI delegated access to the user's Paperless account.

Skill content
metadata: {"clawdbot":{"requires":{"bins":["ppls"],"env":["PPLS_HOSTNAME","PPLS_TOKEN"]}
Recommendation

Use a token/account with only the access needed, keep the token private, and rotate it if it may have been exposed.

What this means

Private or business document text could be displayed or used by the assistant when you ask it to inspect documents.

Why it was flagged

The skill can retrieve full document details including OCR text, which may place sensitive document contents into the agent conversation or outputs.

Skill content
# Get full document details (includes OCR content)
ppls documents show 1234 --json
Recommendation

Ask for specific documents or narrow searches, avoid exposing unnecessary OCR content, and review outputs before sharing them elsewhere.

What this means

Mistyped IDs or broad instructions could add the wrong file or change the wrong document metadata.

Why it was flagged

The documented CLI commands can upload documents and update document metadata. This is purpose-aligned for Paperless organization, but it changes account data.

Skill content
ppls documents add scan.pdf
...
ppls documents update 1234 --title "New Title" --correspondent 5 --tag 10
Recommendation

Confirm document IDs, file paths, and metadata changes before asking the assistant to run modifying commands.

What this means

The installed CLI package will run locally and handle the Paperless token and document operations.

Why it was flagged

The skill depends on installing a global npm CLI package. This is central to the skill's purpose, but it introduces normal package-provenance and update risk.

Skill content
npm install -g @nickchristensen/ppls
Recommendation

Install from the expected npm package, review the linked project if desired, and pin or manage the package version in controlled environments.