Skip to content
TakoAPI
Back to skills

paperless-ngx

by oskarstark

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

Brief

Interact with Paperless-ngx document management system.

Description

What This Skill Does

Connects to a self-hosted Paperless-ngx instance via its REST API to search, upload, download, and organize documents. Supports managing tags, correspondents, document types, and bulk operations across the document archive.

Automates document management tasks that would otherwise require navigating the Paperless-ngx web UI one document at a time.

When to Use It

  • Search invoices by date range and correspondent
  • Upload a scanned receipt and tag it automatically
  • Bulk-tag a set of documents after reorganizing categories
  • Download the OCR'd version of a contract for text extraction
  • Create a new correspondent and reassign existing documents to it

Example Workflow

INPUT

User asks: find all invoices from ACME Corp in 2024 and tag them as 'reviewed'

AGENT
  1. 1

    Query /api/correspondents/ to find ACME Corp's ID

  2. 2

    Search /api/documents/ filtering by correspondent ID and created date range

  3. 3

    Collect document IDs from paginated results

  4. 4

    POST to /api/documents/bulk_edit/ with method 'add_tag' and the 'reviewed' tag ID

OUTPUT

All matching ACME Corp invoices from 2024 are tagged as reviewed

Requirements

  • PAPERLESS_URL environment variable pointing to your Paperless-ngx instance
  • PAPERLESS_TOKEN API token from Paperless-ngx user settings
  • Self-hosted Paperless-ngx instance

Installation

clawhub install oskarstark/paperless-ngx

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

Links