← Back to Skills Marketplace
madmantim

Paperless-ngx Document Manager

by madmantim · GitHub ↗ · v1.0.0
cross-platform ✓ Security Clean
2059
Downloads
3
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install paperless-docs
Description
Manage documents in Paperless-ngx - search, upload, tag, and retrieve.
Usage Guidance
This skill appears to do exactly what it says: it runs small Node scripts that call your Paperless-ngx API. Before installing, ensure you: (1) only provide a PAPERLESS_TOKEN for an account you trust because it can read/upload/delete documents; (2) have Node.js available to run the scripts; (3) review the included scripts (they are provided) and confirm PAPERLESS_URL points to your intended host (not a public or attacker-controlled URL); and (4) be cautious about file paths you pass to upload/download (they read/write user-specified files). If you want to limit risk, create a Paperless user with scoped permissions for automation rather than reusing a full-admin token.
Capability Analysis
Type: OpenClaw Skill Name: paperless-docs Version: 1.0.0 The skill bundle provides a set of Node.js scripts for managing documents in Paperless-ngx via its REST API. All scripts correctly utilize `PAPERLESS_URL` and `PAPERLESS_TOKEN` environment variables for authentication and API interaction. File system access is limited to reading user-specified files for upload (`scripts/upload.mjs`) and writing downloaded documents to user-specified or current directory paths (`scripts/download.mjs`), which are legitimate functions for a document management skill. The `SKILL.md` and `references/api.md` files serve as documentation and do not contain any prompt injection attempts or instructions for malicious actions. There is no evidence of data exfiltration, unauthorized execution, persistence, or obfuscation.
Capability Assessment
Purpose & Capability
Name/description match the included Node scripts and API reference. The requested env vars (PAPERLESS_URL, PAPERLESS_TOKEN) are exactly what a Paperless-ngx client needs; no unrelated services or binaries are requested.
Instruction Scope
SKILL.md and scripts confine actions to the Paperless API and user-specified filesystem paths (upload reads a given file; download writes to a chosen path). There are no instructions to read unrelated system files, other credentials, or to exfiltrate data to third-party domains; all network calls target ${PAPERLESS_URL}/api/.
Install Mechanism
No install spec is present (instruction + scripts only). Scripts require a Node.js environment to run, which is expected for .mjs files; nothing is downloaded from untrusted URLs or written to system locations by an installer.
Credentials
Only PAPERLESS_URL and PAPERLESS_TOKEN are required and the primary credential is the API token — appropriate for this integration. Note: the token grants access to documents and metadata on the Paperless instance, so treat it as sensitive.
Persistence & Privilege
always:false and there is no request to modify other skills or global agent configuration. The skill can be invoked autonomously by the agent (platform default), but it does not request elevated or persistent system privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install paperless-docs
  3. After installation, invoke the skill by name or use /paperless-docs
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: search, upload, download, tag, and manage documents via Paperless-ngx REST API
Metadata
Slug paperless-docs
Version 1.0.0
License
All-time Installs 5
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is Paperless-ngx Document Manager?

Manage documents in Paperless-ngx - search, upload, tag, and retrieve. It is an AI Agent Skill for Claude Code / OpenClaw, with 2059 downloads so far.

How do I install Paperless-ngx Document Manager?

Run "/install paperless-docs" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Paperless-ngx Document Manager free?

Yes, Paperless-ngx Document Manager is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Paperless-ngx Document Manager support?

Paperless-ngx Document Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Paperless-ngx Document Manager?

It is built and maintained by madmantim (@madmantim); the current version is v1.0.0.

💬 Comments