npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@mephistojb/n8n-nodes-paperless

v0.2.17

Published

N8N community node manage your documents with Paperless-ngx.

Downloads

1,065

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

mephistojbmephistojb

Keywords

n8n-community-node-packagepaperlesspaperless-ngx

Readme

Banner image

@mephistojb/n8n-nodes-paperless

This is an independent n8n community node package. It lets you use Paperless-ngx in your n8n workflows.

Document updates support Paperless searchable content in addition to document metadata. They also support expression-friendly JSON arrays for tags and custom fields, including targeted tag removal while preserving all other document tags.

Paperless-ngx is a document management system that transforms your physical documents into a searchable online archive so you can keep your paper documents, but lose the cabinet.

Installation
Operations
Credentials
Compatibility
Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Install this package in n8n as:

@mephistojb/n8n-nodes-paperless

[!NOTE] This node requires the form-data package for handling multipart/form-data requests. It will be automatically installed as a dependency if not already present in your n8n installation.

Operations

The node supports the following resources and operations:

ASN (Archival Series Number)

  • Get next ASN

Correspondent

  • Create/Update/Delete correspondent
  • Get a correspondent
  • List all correspondents

Custom Field

  • Create/Update/Delete custom field
  • Get a custom field
  • List all custom fields

Document

  • Create/Update/Delete document
  • Get a document, including metadata JSON and the original file as binary data
  • Get document history
  • Get document metadata
  • Get metadata suggestions
  • Get document preview and thumbnail as binary data
  • Include documents with selected tags, exclude documents carrying any selected tag, and limit queue-sized results
  • Get document share links
  • List all documents, optionally filtered by title, tags, document type, and storage path

Document Metadata

  • Get metadata suggestions

Document Note

  • Create/Delete document note
  • List document notes

Document Type

  • Create/Update/Delete document type
  • Get a document type
  • List all document types

Tag

  • Create/Update/Delete tag
  • Get a tag
  • List all tags

Storage Path

  • Create/Update/Delete storage path
  • Get a storage path
  • List all storage paths

Task

  • Get a task

AI Tools

This node can also be used to interact with the AI tools agent. However, keep in mind that it is currently not officially supported by n8n and needs some changes to the n8n codebase to work. For more details, see this issue.

Credentials

You need to provide the following to authenticate:

  • Paperless-ngx instance URL
  • API token

The instance URL can be either the Paperless-ngx base URL, such as http://paperless:8000, or the API URL, such as http://paperless:8000/api.

To get your API token:

  1. Login to your Paperless-ngx instance
  2. Go to your user settings
  3. Create a new API token

Compatibility

Requires n8n version 1.0.0 or later and Paperless-ngx version 2.14.0 or later. Earlier versions may work but are not officially supported or tested.

Publishing

The Publish to npm workflow runs on every push to main, when a stable GitHub release is published, and when manually started from the GitHub Actions page.

  1. Configure a trusted GitHub Actions publisher for the package on npmjs.com using repository MephistoJB/n8n-nodes-paperless-ngx and workflow publish-npm.yml.
  2. Push a change to main, manually run the workflow, or create a GitHub release whose tag matches the package version.

If the version already exists on npm, push and manual runs automatically increment the patch version before publishing and commit that version back to main. Stable releases keep their explicit tag version. The workflow type checks the project, runs the package's prepublish build and lint checks, and publishes the scoped package through npm trusted publishing with automatic provenance.

Resources

License

MIT