# Paperless

> Search and manage documents in Paperless-ngx document management system. Use when the user asks about documents, invoices, receipts, tax forms, bills, or wants to search their document library.

- Skill: `majiayu000/paperless` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/paperless`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/paperless/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/paperless

---


# Paperless-ngx

Interact with Paperless-ngx document management system via CLI.

## Setup

Environment: `~/.secrets.env` (PAPERLESS_URL, PAPERLESS_TOKEN) - loaded by
wrapper.

## CLI Discovery

Run `paperless-cli --help` to see available commands. Run
`paperless-cli <command> --help` for detailed usage of any command.

## Capabilities

The CLI supports:

- **Search**: Full-text search with filters (date ranges, tags, correspondents)
- **Browse**: List recent documents, inbox items
- **Read**: Get document details and extracted text content
- **Organize**: Add/remove tags, edit metadata (title, correspondent, type)
- **Find related**: Discover similar documents
- **Download**: Save original files locally
- **Metadata**: List tags, correspondents, document types, stats

## Workflow

1. Search or list to find documents
2. Get document by ID to read full content
3. Add/remove tags to organize
4. Find similar documents for related items
5. Download originals when needed

## Notes

- Flags must come BEFORE positional arguments
- Document IDs are integers returned from search/list results