How do I install the Paperless skill?

Run npx skillmds add majiayu000/paperless-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Paperless safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Paperless?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Paperless free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Paperless?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Paperless by majiayu000 — Agent Skill

Name: Paperless
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

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.

majiayu000 62a75f9 2 files · 2.5 KB Updated Sep 9, 2026 567 repo stars

File contents

Paperless-ngx

Interact with Paperless-ngx document management system via CLI.

Setup

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

Run commands via:

paperless-cli <command>

Commands Reference

See CLI-REFERENCE.md for full command documentation.

Quick Reference

Command	Purpose
`search [query]`	Full-text search with filters
`list`	Recent documents, `--inbox` for inbox
`get <id>`	Document details and content
`download <id>`	Download original file
`edit <id>`	Edit title/correspondent/type
`similar <id>`	Find similar documents
`add-tag <id> <tag>`	Add tag to document
`remove-tag <id> <tag>`	Remove tag from document
`tags`	List all tags
`correspondents`	List all correspondents
`types`	List all document types
`stats`	System statistics

Workflow

Start with search or list to find documents
Use get <id> to read full content
Use add-tag/remove-tag to organize
Use similar <id> to find related documents
Use download <id> to save original files

Examples

Important: Flags must come BEFORE positional arguments (query text).

"Find my tax documents from 2023"

search "tax 2023"
# or with filters (flags before query):
search --tag tax --after 2023-01-01 --before 2024-01-01

"What's in my inbox?"

list --inbox

"Show me that W-2"

get 1234

"Tag document 1234 as reviewed"

add-tag 1234 reviewed --create

"Find similar documents to this receipt"

similar 1234

"Download that PDF"

download 1234

---name: paperless-2description: 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.--- # Paperless-ngx Interact with Paperless-ngx document management system via CLI. ## Setup Environment: `~/.secrets.env` (PAPERLESS_URL, PAPERLESS_TOKEN) - loaded by wrapper Run commands via: ```bash paperless-cli <command> ``` ## Commands Reference See [CLI-REFERENCE.md](CLI-REFERENCE.md) for full command documentation. ### Quick Reference | Command | Purpose | |---------|---------| | `search [query]` | Full-text search with filters | | `list` | Recent documents, `--inbox` for inbox | | `get <id>` | Document details and content | | `download <id>` | Download original file | | `edit <id>` | Edit title/correspondent/type | | `similar <id>` | Find similar documents | | `add-tag <id> <tag>` | Add tag to document | | `remove-tag <id> <tag>` | Remove tag from document | | `tags` | List all tags | | `correspondents` | List all correspondents | | `types` | List all document types | | `stats` | System statistics | ## Workflow 1. Start with `search` or `list` to find documents 2. Use `get <id>` to read full content 3. Use `add-tag`/`remove-tag` to organize 4. Use `similar <id>` to find related documents 5. Use `download <id>` to save original files ## Examples **Important:** Flags must come BEFORE positional arguments (query text). **"Find my tax documents from 2023"** ```bash search "tax 2023" # or with filters (flags before query): search --tag tax --after 2023-01-01 --before 2024-01-01 ``` **"What's in my inbox?"** ```bash list --inbox ``` **"Show me that W-2"** ```bash get 1234 ``` **"Tag document 1234 as reviewed"** ```bash add-tag 1234 reviewed --create ``` **"Find similar documents to this receipt"** ```bash similar 1234 ``` **"Download that PDF"** ```bash download 1234 ```

Frequently asked questions