paperless-ngx
by oskarstark
Self-Hosted & AutomationBrief
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
User asks: find all invoices from ACME Corp in 2024 and tag them as 'reviewed'
- 1
Query /api/correspondents/ to find ACME Corp's ID
- 2
Search /api/documents/ filtering by correspondent ID and created date range
- 3
Collect document IDs from paginated results
- 4
POST to /api/documents/bulk_edit/ with method 'add_tag' and the 'reviewed' tag ID
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-ngxRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.