paperless-cli

Manage Paperless-ngx documents via command-line interface.

6|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/julianfbeck/paperless-cli --skill paperless-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paperless-cli
Source: https://github.com/julianfbeck/paperless-cli/tree/main
Command: npx skills add https://github.com/julianfbeck/paperless-cli --skill paperless-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines managing your Paperless-ngx library from the command line instead of clicking through the web UI, saving time for frequent document workflows.

Core Features & Use Cases

  • Document management: list, search, view metadata, download, upload, edit metadata, and delete documents.
  • Organization controls: list/create/edit/delete tags, correspondents, and document types to keep uploads consistent.
  • Operational support: check asynchronous upload task status and extract local PDF text for quick inspection before importing.
  • Example use case: You receive a batch of invoices as PDFs, quickly upload them with the correct titles/tags, then search the library by query to verify everything landed correctly.

Quick Start

Use the skill to list your most recent Paperless documents matching an invoice query and return the results to you.

Frequently Asked Questions about paperless-cli

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

FAQPage Schema
How do I manage Paperless-ngx documents from the command line?

You can manage Paperless-ngx documents from the command line by using a CLI tool to list, search, upload, download, edit metadata, and delete documents via API authentication. This streamlines frequent document workflows without needing the web UI.

Can I upload PDFs and check asynchronous task status in Paperless-ngx?

Yes, you can upload PDFs and check asynchronous upload task status in Paperless-ngx. The CLI supports monitoring task progress and extracting local PDF text for quick inspection before importing documents into your library.

What is the best way to search and retrieve invoices from a Paperless-ngx library?

The best way to search and retrieve invoices from a Paperless-ngx library is using a CLI tool that queries your document database by tags, correspondents, or document types, returning JSON or non-JSON output for scripting.

Do I need a YAML configuration and API token to use a Paperless-ngx CLI?

Yes, you need a YAML-defined discovery metadata file and API authentication via a configured server URL and token to use a Paperless-ngx CLI. These prerequisites ensure secure communication with your document management instance.

How do I edit metadata for tags and correspondents in Paperless-ngx?

You edit metadata for tags and correspondents in Paperless-ngx by executing CLI commands that list, create, edit, or delete organization controls. This ensures your document uploads remain consistent across your library.