Agent skill · software engineering · sundial-org
paperless-ngx
Interact with Paperless-ngx document management system via REST API. Use when users want to search, upload, download, organize documents, manage tags, correspondents, or document types in their Paperless-ngx instance.
Why this skill is useful
Adds executable scripts for interacting with the Paperless-ngx API that automate document management tasks.
What it needs
Requires curl installed locally. Requires paperless-ngx account access. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Paperless-ngx Skill Manage documents in Paperless-ngx via its REST API using HTTP requests. Configuration Requires environment variables: PAPERLESSURL: Base URL (e.g., https://paperless.example.com) PAPERLESSTOKEN: API token from Paperless-ngx settings Authentication Include token in all requests: Core Operations Search Documents Filter options: correspondentid, documenttypeid, tagsidin, createddategte, createddatelte, addeddategte. Get Document Details Download Document Upload Document Optional fields: title, created, correspondent, documenttype, storagepath, tags (repeatable), archiveserialnumber, customfields. Update Document Metadata Delete Document Organization Endpoints Tags Correspondents Document Types Bulk Operations Methods: setcorrespondent, setdocumenttype, addtag, removetag, delete, reprocess. Task Status After upload, check task status: Response Handling List endpoints return {"count": N, "results": [...]} with pagination Single objects return the object directly Use ?page=2 for pagination Add ?ordering=-created for sorting (prefix - for descending)
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/paperless-ngx