paperskill

Query Paperless-ngx documents by filters and update metadata via CLI.

7|2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/ragnvald/paperskill --skill paperskill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paperskill
Source: https://github.com/ragnvald/paperskill/tree/main
Command: npx skills add https://github.com/ragnvald/paperskill --skill paperskill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

It enables users to efficiently locate, read, and modify documents stored in Paperless-ngx using command-line scripts.

Core Features & Use Cases

  • Document Search: Find documents based on keywords, tags, types, and date ranges without downloading content.
  • Content Retrieval: Download document files or extract their OCR/text content for review or processing.
  • Metadata Update: Modify document attributes like tags, title, or associated contact, streamlining digital document management.
  • Use Case: For instance, a user can quickly search for all receipts from January 2024 and mark some as important directly from the terminal.

Quick Start

Use this skill to find invoice documents tagged as receipts created after January 1, 2024.

Frequently Asked Questions about paperskill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for documents in Paperless-ngx using tags and date ranges?

You can search for documents in Paperless-ngx by applying specific server-side filters for keywords, tags, document types, and date ranges. This enables efficient document retrieval without downloading the actual file content.

Can I extract OCR text content from Paperless-ngx documents via API?

Yes, you can retrieve document files or extract their OCR and text content through the Paperless-ngx API. This allows you to review and process the document content directly without exposing raw content unless explicitly requested.

How do I update document metadata like tags and titles in Paperless-ngx?

You can modify document metadata attributes such as tags, titles, and associated contacts using the Paperless-ngx API. This streamlines digital document management by allowing direct updates from command-line scripts.

Does the Paperless-ngx API support pagination for scalable document searches?

Yes, the Paperless-ngx API supports pagination handling to ensure scalable document searches. This allows you to efficiently query and retrieve large volumes of documents stored on the server.

What is the best way to manage Paperless-ngx receipts from the command line?

The best way to manage Paperless-ngx receipts from the command line is using scripts that perform server-side querying. You can search for specific receipt documents by date range and modify their metadata directly from the terminal.