paperless-mcp · MCP Server

Beschreibung des Anbieters

Model Context Protocol (MCP) server for interacting with Paperless-NGX document management system. Enables AI assistants to manage documents, tags, correspondents, and document types through the Paperless-NGX API.

Werkzeuge

list_mail_accounts

List Paperless mail accounts for selecting the account ID needed by mail rules. Does not expose account passwords. Angabe des Anbieters · Beleg 5

get_mail_account

Get one Paperless mail account by ID. Password/token fields are redacted if the server returns them. Angabe des Anbieters · Beleg 5

process_mail_account

Manually run Paperless mail processing for one account. This can consume matching mails according to enabled Paperless mail rules. Angabe des Anbieters · Beleg 5

list_mail_rules

List Paperless mail rules with optional pagination. Angabe des Anbieters · Beleg 5

get_mail_rule

Get one Paperless mail rule by ID. Angabe des Anbieters · Beleg 5

create_mail_rule

Create a Paperless mail rule. Use list_mail_accounts first to choose account. Prefer attachment-only rules for invoices unless the full mail must be archived. Angabe des Anbieters · Beleg 5

update_mail_rule

Patch an existing Paperless mail rule. Only supplied fields are changed. Angabe des Anbieters · Beleg 5

delete_mail_rule

Delete one Paperless mail rule. This changes future mail ingestion behavior but does not delete documents. Angabe des Anbieters · Beleg 5

list_tags

List all tags.… Angabe des Anbieters · Beleg 6

create_tag

Create a new tag with optional color, matching pattern, and matching algorithm for automatic document tagging. Angabe des Anbieters · Beleg 6

update_tag

Update an existing tag's name, color, matching pattern, or matching algorithm. Angabe des Anbieters · Beleg 6

delete_tag

⚠️ DESTRUCTIVE: Permanently delete a tag from the entire system. This will remove the tag from ALL documents that use it. Use with extreme caution. Angabe des Anbieters · Beleg 6

bulk_edit_tags

Bulk edit tags. ⚠️ WARNING: 'delete' operation permanently removes tags from the entire system. Use with caution. Angabe des Anbieters · Beleg 6

list_document_notes

List all notes attached to a document. Notes are free-text comments on a document and are the natural place for an audit trail (e.g.… Angabe des Anbieters · Beleg 7

create_document_note

Add a note to a document. Use this to record an audit trail or progress note directly on the document. Returns the document's full list of notes after the note is added. Angabe des Anbieters · Beleg 7

delete_document_note

⚠️ DESTRUCTIVE: Permanently delete a single note from a document by its note ID. This operation is irreversible. Returns the document's remaining notes. Angabe des Anbieters · Beleg 7

bulk_edit_documents

Perform bulk operations on multiple documents. Note: 'remove_tag' removes a tag from specific documents (tag remains in system), while 'delete_tag' permanently deletes a tag from the entire system.… Angabe des Anbieters · Beleg 8

post_document

Upload a new document to Paperless-NGX with optional metadata like title, correspondent, document type, tags, and custom fields.… Angabe des Anbieters · Beleg 8

list_documents

List and filter documents with pagination and common Paperless filters such as title search, correspondent, document type, tag, storage path, creation date, archive serial number, and simple custom… Angabe des Anbieters · Beleg 8

query_documents

Query documents using the full-text query engine plus structured Paperless filters.… Angabe des Anbieters · Beleg 8

get_document

Get a specific document by ID with full details including correspondent, document type, tags, and custom fields. Note: Document content is excluded from results by default.… Angabe des Anbieters · Beleg 8

get_document_content

Get the text content of a specific document by ID. Use this when you need to read or analyze the actual document text. Angabe des Anbieters · Beleg 8

search_documents

Deprecated compatibility wrapper for full-text document search. Use 'query_documents' with the 'query' argument for new integrations. Note: Document content is excluded from results by default.… Angabe des Anbieters · Beleg 8

download_document

Download a document file by ID. Returns a paperless:// resource URI; read the resource to fetch the file content. Angabe des Anbieters · Beleg 8

get_document_thumbnail

Get a document thumbnail (image preview) by ID. Returns a paperless:// resource URI; read the resource to fetch the image content. Angabe des Anbieters · Beleg 8

update_document

Update a specific document with new values (title, correspondent, document type, storage path, tags, custom fields, and more). Top-level fields you omit are left unchanged.… Angabe des Anbieters · Beleg 8

list_custom_fields

List all custom fields.… Angabe des Anbieters · Beleg 9

get_custom_field

Get a specific custom field by ID with full details including data type and extra configuration. Angabe des Anbieters · Beleg 9

create_custom_field

Create a new custom field with a specified data type (string, url, date, boolean, integer, float, monetary, documentlink, or select).… Angabe des Anbieters · Beleg 9

update_custom_field

Update an existing custom field's name, data type, or extra configuration data. Angabe des Anbieters · Beleg 9

Voraussetzungen

• PAPERLESS_URL · Umgebungsvariable · erforderlich · Beleg 10
• PAPERLESS_API_KEY · Umgebungsvariable · erforderlich · Beleg 10
• PAPERLESS_PUBLIC_URL · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 11
• PAPERLESS_MCP_UPLOAD_PATHS · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 8
• PAPERLESS_API_VERSION · Umgebungsvariable · Pflichtigkeit nicht deklariert · Beleg 12

Eckdaten

—: Angabe nicht belegt.

Maintainer

baruchiro

Repository-Lizenz

ISC

Letzter Repository-Commit

2026-09-15

Commit innerhalb 90 Tagen

Dienstanbieter

Offizielle Dienstherkunft nicht belegt

Dienste

—

Bereiche

Content, Büro

Plattformen

—

Version

2.2.1

Release

v2.2.1

Clients

Claude

Repository-Themen

ai, document-management, mcp, mcp-server, paperless-ngx

Zugriffe und Risiken

Zugriffe laut Paketangaben

lesen, schreiben, löschen, senden

Authentifizierung

—

Transport

—

Technische Prüfung

Ungeprüft

Fehlende Angaben bedeuten unbekannte Zugriffe: Vergib nur die nötigen Berechtigungen und sichere Schreibaktionen mit einer Freigabe ab.