Was ist Paperless-NGX MCP Server?
Das ist der gepflegte Fork von nloui/paperless-mcp, dem ursprünglichen MCP-Server für Paperless-ngx, dessen letzter Commit vom 11. November 2025 stammt. Baruch Rothkoffs Fork (baruchiro/paperless-mcp) hat etwa 149 GitHub-Sterne gegenüber 248 beim Original, ist aber der, der weiter ausliefert: v2.2.1 erschien am 11. September 2026, und sein npm-Paket hatte in der Woche bis zum 29. Oktober 2026 683 Downloads gegenüber 171 beim Original.
Er kapselt die REST-API von Paperless-ngx mit etwa 31 Tools für Dokumente, Notizen, Tags, Korrespondenten, Dokumenttypen, benutzerdefinierte Felder sowie Mail-Konten und -Regeln. Er läuft über stdio mit npx -y @baruchiro/paperless-mcp@latest oder als Docker-Image, das Streamable HTTP und SSE auf Port 3000 bereitstellt. Er braucht die URL deiner Paperless-ngx-Instanz und einen API-Token von deiner Profilseite. Das Repository steht unter ISC-Lizenz.
Paperless-NGX MCP Server installieren
npx -y @baruchiro/paperless-mcp@latestLohnt sich Paperless-NGX MCP Server?
Wer Briefe, Rechnungen und Steuerunterlagen schon in Paperless-ngx aufbewahrt, macht mit diesem Server das Archiv zu etwas, das ein Agent durchsuchen und neu ordnen kann. query_documents reicht Volltextsuche, Ähnlichkeitssuche und strukturierte Abfragen über benutzerdefinierte Felder durch, etwa um jede Rechnung ohne Rechnungsnummer zu finden. Das deckt das meiste ab, was ein Mensch in der Weboberfläche tut.
Die Tool-Liste geht weit über das Lesen hinaus. bulk_edit_documents kann Dokumente zusammenführen, teilen, drehen, Seiten daraus oder ganze Dokumente löschen und ihre Berechtigungen ändern; post_document lädt Dateien bis 100 MB hoch; die Mail-Tools erstellen und bearbeiten die Regeln, die festlegen, was Paperless aus deinem Posteingang holt. Nur das Löschen von Notizen und Mail-Regeln verlangt ein ausdrückliches Bestätigungs-Flag. Ein Massenlöschen nicht, die Freigabeabfrage des Clients ist also der einzige Schutz.
Die Sicherheitsarbeit des Forks ist der Hauptgrund, ihn dem Original vorzuziehen. Version 2.0.0 sorgte dafür, dass der HTTP-Modus Anfragen ohne Bearer-Token ablehnt, und schloss damit einen Endpunkt, der zuvor für jeden Aufrufer im Netzwerk auf den eigenen Schlüssel des Servers zurückfiel. Jeder HTTP-Client sendet nun seinen eigenen Paperless-Token, sodass die Paperless-Berechtigungen pro Nutzer gelten. Uploads per Dateipfad lesen jede Datei, die der Prozess sehen kann, sofern PAPERLESS_MCP_UPLOAD_PATHS sie nicht einschränkt, und diese Variable ist optional.
Die Schwächen sind die üblichen eines Community-Servers mit einem einzigen Maintainer. Paperless-ngx v3.0.0 hat REST-API-Versionen unter 9 gestrichen, und ältere Konfigurationen sehen nun HTTP-406-Fehler, bis PAPERLESS_API_VERSION gesetzt ist. Die Dokumentation ist ein langes README statt einer Doku-Website. Dokumenttext aus gescannter Post ist nicht vertrauenswürdige Eingabe, ein Agent, der ihn liest, ist also Prompt Injection ausgesetzt, während er Schreibzugriff auf das Archiv hat.
Wo es sich lohnt
Eine Freiberuflerin mit fünf Jahren Rechnungen und Belegen in Paperless-ngx
Vor der Steuererklärung jede Rechnung von 2025 finden, der noch die Rechnungsnummer fehlt
query_documents mit einer Abfrage über ein benutzerdefiniertes Feld listet die Lücken, und bulk_edit_documents taggt sie zur Nachbearbeitung. Kostenlos auf einer bestehenden Paperless-Installation; der Aufwand sind ein paar Tool-Aufrufe und die Prüfung jeder Massenbearbeitung.
Ein Homelab-Betreiber, der die Hauspost in Paperless scannt
Mail-Regeln einrichten, damit Versorgerrechnungen automatisch aus der E-Mail geholt und getaggt werden
Der Agent listet die Mail-Konten und ruft dann create_mail_rule mit Absender- und Betrefffiltern und den zuzuweisenden Tags auf. Kontopasswörter werden in der Tool-Ausgabe geschwärzt, aber eine falsche Regel kann Mails im echten Posteingang markieren oder verschieben.
Eine kleine Steuerkanzlei, die Paperless für Mandantenakten selbst hostet
Zwei Mitarbeitenden einen Assistenten geben, der respektiert, wer die Dokumente welches Mandanten sehen darf
Betreibe das Docker-Image im HTTP-Modus und lass jeden Client seinen eigenen Paperless-Token als Bearer-Header senden, damit die Paperless-Berechtigungen pro Person gelten. Halte den Server vom öffentlichen Internet fern und setze --no-auth nicht.
Bevor du dich festlegst
- Einrichtung
- Trag npx -y @baruchiro/paperless-mcp@latest mit PAPERLESS_URL und PAPERLESS_API_KEY in die Client-Konfiguration ein oder starte ghcr.io/baruchiro/paperless-mcp für HTTP und SSE auf Port 3000. Das README hat einen Installationslink für Cursor und ein Beispiel für Continue; mit einem Token dauert es ein paar Minuten.
- Integrationen
- Etwa 31 Tools: Dokumente auflisten, abfragen, herunterladen und hochladen, Vorschaubilder, Notizen, Tags, Korrespondenten, Dokumenttypen, benutzerdefinierte Felder sowie Mail-Konten und -Regeln. Rund die Hälfte davon schreibt.
- Daten und Datenschutz
- Alles, was der API-Token erreicht, einschließlich Löschen. Im HTTP-Modus muss seit v2.0.0 jede Anfrage ihren eigenen Bearer-Token mitbringen, sofern --no-auth nicht gesetzt ist. Uploads per Dateipfad lesen jede lokale Datei, sofern PAPERLESS_MCP_UPLOAD_PATHS nicht gesetzt ist. Es sind keine GitHub-Sicherheitshinweise veröffentlicht.
- Kosten im großen Maßstab
- Kostenlos; Paperless-ngx ist selbst gehostet, die einzigen Kosten sind also dein Server und die Modell-Tokens. Große Ergebnisseiten und base64-Uploads sind die Hauptquellen für aufgeblähten Kontext.
- Grenzen
- Paperless-ngx v3.0.0 lehnt API-Versionen unter 9 mit HTTP 406 ab. search_documents ist zugunsten von query_documents veraltet. Destruktive Massenmethoden haben kein Bestätigungs-Flag.
Was gut ist
- Etwa 31 Tools, einschließlich Abfragen über benutzerdefinierte Felder und Mail-Regeln
- Bearer-Token pro Anfrage im HTTP-Modus seit v2.0.0
- npx und Docker-Images; End-to-End-Tests gegen echtes Paperless-ngx
- Aktiv gepflegt, anders als das ursprüngliche Repo
Was nicht
- Massenlöschen, Zusammenführen und Teilen laufen ohne Bestätigungs-Flag
- Uploads per Dateipfad sind uneingeschränkt, solange du keine Allowlist setzt
- Ein einziger Maintainer; etwa 149 Sterne
- Ältere Setups bekommen nach Paperless-ngx 3.0 HTTP 406
Am besten für
Paperless-ngx-Nutzer, die einen Agenten Dokumente finden, verschlagworten und ablegen lassen wollen und Schreibaufrufe hinter Freigabeabfragen halten.
Alternativen zu Paperless-NGX MCP Server
Paperless-NGX MCP Server: häufige Fragen
- Lohnt sich Paperless-NGX MCP Server?
- Der Paperless-ngx-Server, der die Installation lohnt, umfangreich genug für den ganzen Arbeitstag eines Ablagesachbearbeiters, und umfangreich genug, um dein Archiv zu löschen, wenn du ihn lässt. Wir bewerten es mit 3.8 von 5.
- Was kostet Paperless-NGX MCP Server?
- Kostenlos und Open Source (ISC). Paperless-ngx selbst ist kostenlos und selbst gehostet.
- Welche Nachteile hat Paperless-NGX MCP Server?
- Massenlöschen, Zusammenführen und Teilen laufen ohne Bestätigungs-Flag; Uploads per Dateipfad sind uneingeschränkt, solange du keine Allowlist setzt; Ein einziger Maintainer; etwa 149 Sterne; Ältere Setups bekommen nach Paperless-ngx 3.0 HTTP 406.
- Für wen eignet sich Paperless-NGX MCP Server?
- Paperless-ngx-Nutzer, die einen Agenten Dokumente finden, verschlagworten und ablegen lassen wollen und Schreibaufrufe hinter Freigabeabfragen halten.
- Was kostet Paperless-NGX MCP Server für ein Team oder im Produktivbetrieb?
- Kostenlos; Paperless-ngx ist selbst gehostet, die einzigen Kosten sind also dein Server und die Modell-Tokens. Große Ergebnisseiten und base64-Uploads sind die Hauptquellen für aufgeblähten Kontext.
- Ist Paperless-NGX MCP Server sicher für Firmendaten?
- Alles, was der API-Token erreicht, einschließlich Löschen. Im HTTP-Modus muss seit v2.0.0 jede Anfrage ihren eigenen Bearer-Token mitbringen, sofern --no-auth nicht gesetzt ist. Uploads per Dateipfad lesen jede lokale Datei, sofern PAPERLESS_MCP_UPLOAD_PATHS nicht gesetzt ist. Es sind keine GitHub-Sicherheitshinweise veröffentlicht.
- Was sind die besten Alternativen zu Paperless-NGX MCP Server?
- Die nächsten Alternativen, die wir getestet haben, sind Filesystem (reference server), MarkItDown MCP und Zotero MCP.
Antworten geprüft am 31. Okt. 2026.