Skip to content
TakoAPI
Back to skills

paperless

by nickchristensen

Self-Hosted & Automation
2.3kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Interact with Paperless-NGX document management system via ppls.

Description

What This Skill Does

Connects AI agents to a Paperless-NGX instance using the ppls CLI. Supports searching, filtering, uploading, downloading, and updating document metadata.

Using the JSON output mode makes document queries directly parseable by agents without any scraping or screen interaction.

When to Use It

  • Find all invoices from a specific vendor in the last year
  • Download a contract by searching its title
  • Upload a scanned receipt with tags and correspondent assigned
  • List documents missing a correspondent for cleanup
  • Check which documents were added or modified this month

Example Workflow

INPUT

User asks: Find all tax documents from 2024 tagged as Tax and download them

AGENT
  1. 1

    Run ppls tags list --json to find the tag ID for Tax 2024

  2. 2

    Run ppls documents list --tag <id> --created-after 2024-01-01 --created-before 2024-12-31 --json to get matching document IDs

  3. 3

    Run ppls documents download <ids> --output-dir ~/Downloads/tax-2024 for each result

OUTPUT

PDF files downloaded to ~/Downloads/tax-2024

Requirements

  • PPLS_HOSTNAME environment variable (URL of your Paperless-NGX instance)
  • PPLS_TOKEN environment variable (API token from your Paperless-NGX account)
  • Paperless-NGX instance (self-hosted)

Installation

clawhub install nickchristensen/paperless

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links