Qu’est-ce que Paperless-NGX MCP Server ?
Il s'agit du fork maintenu de nloui/paperless-mcp, le serveur MCP d'origine pour Paperless-ngx, dont le dernier commit date du 11 novembre 2025. Le fork de Baruch Rothkoff (baruchiro/paperless-mcp) compte environ 149 étoiles sur GitHub contre 248 pour l'original, mais c'est lui qui continue à publier : la v2.2.1 est sortie le 11 septembre 2026, et son paquet npm a été téléchargé 683 fois dans la semaine jusqu'au 29 octobre 2026, contre 171 pour l'original.
Il enveloppe l'API REST de Paperless-ngx avec environ 31 outils couvrant documents, notes, étiquettes, correspondants, types de documents, champs personnalisés, ainsi que comptes et règles de courrier. Il tourne en stdio avec npx -y @baruchiro/paperless-mcp@latest, ou comme image Docker servant Streamable HTTP et SSE sur le port 3000. Il demande l'URL de votre instance Paperless-ngx et un token d'API depuis votre page de profil. Le dépôt est sous licence ISC.
Installer Paperless-NGX MCP Server
npx -y @baruchiro/paperless-mcp@latestPaperless-NGX MCP Server vaut-il le coup ?
Pour ceux qui conservent déjà lettres, factures et papiers fiscaux dans Paperless-ngx, ce serveur fait de l'archive quelque chose qu'un agent peut fouiller et réorganiser. query_documents relaie la recherche plein texte, la recherche de documents similaires et les requêtes structurées sur les champs personnalisés, par exemple pour trouver toutes les factures sans numéro de facture. Cela couvre l'essentiel de ce qu'une personne fait dans l'interface web.
La liste des outils va bien au-delà de la lecture. bulk_edit_documents peut fusionner, scinder et faire pivoter des documents, en supprimer des pages ou les supprimer entièrement, et modifier leurs permissions ; post_document envoie des fichiers jusqu'à 100 MB ; les outils de courrier créent et modifient les règles qui déterminent ce que Paperless récupère dans votre boîte de réception. Seules la suppression de notes et celle de règles de courrier demandent un indicateur de confirmation explicite. Une suppression en masse ne le demande pas : l'invite d'approbation du client est donc la seule protection.
Le travail de sécurité du fork est la principale raison de le préférer à l'original. La version 2.0.0 a fait rejeter par le mode HTTP les requêtes sans token Bearer, fermant un endpoint qui se rabattait auparavant sur la clé du serveur pour n'importe quel appelant du réseau. Chaque client HTTP envoie désormais son propre token Paperless, si bien que les permissions de Paperless s'appliquent par utilisateur. Les envois par chemin de fichier lisent n'importe quel fichier visible par le processus, sauf si PAPERLESS_MCP_UPLOAD_PATHS les restreint, et cette variable est facultative.
Les points faibles sont ceux habituels d'un serveur communautaire à mainteneur unique. Paperless-ngx v3.0.0 a abandonné les versions de l'API REST inférieures à 9, et les anciennes configurations voient désormais des erreurs HTTP 406 tant que PAPERLESS_API_VERSION n'est pas défini. La documentation est un long README plutôt qu'un site dédié. Le texte des documents issus de courrier numérisé est une entrée non fiable, donc un agent qui le lit est exposé à l'injection de prompts tout en ayant un accès en écriture à l'archive.
Là où il fait la différence
Une indépendante avec cinq ans de factures et de reçus dans Paperless-ngx
Trouver toutes les factures de 2025 encore sans numéro de facture avant la déclaration d'impôts
query_documents avec une requête sur un champ personnalisé liste les manques et bulk_edit_documents les étiquette pour suivi. Gratuit sur une installation Paperless existante ; le coût se résume à quelques appels d'outils et à la relecture de chaque modification en masse.
Un passionné de home lab qui numérise le courrier du foyer dans Paperless
Mettre en place des règles de courrier pour que les factures d'énergie soient récupérées dans les e-mails et étiquetées automatiquement
L'agent liste les comptes de courrier, puis appelle create_mail_rule avec des filtres d'expéditeur et d'objet et les étiquettes à attribuer. Les mots de passe des comptes sont masqués dans la sortie des outils, mais une règle erronée peut marquer ou déplacer des messages dans la vraie boîte de réception.
Un petit cabinet comptable qui auto-héberge Paperless pour les dossiers clients
Donner à deux collaborateurs un assistant qui respecte qui peut voir les documents de quel client
Lancez l'image Docker en mode HTTP et faites envoyer à chaque client son propre token Paperless en en-tête Bearer, pour que les permissions de Paperless s'appliquent par personne. Gardez le serveur hors de l'internet public et n'activez pas --no-auth.
Avant de vous engager
- Mise en route
- Ajoutez npx -y @baruchiro/paperless-mcp@latest avec PAPERLESS_URL et PAPERLESS_API_KEY à la configuration du client, ou lancez ghcr.io/baruchiro/paperless-mcp pour HTTP et SSE sur le port 3000. Le README propose un lien d'installation pour Cursor et un exemple pour Continue ; comptez quelques minutes une fois le token en main.
- Intégrations
- Environ 31 outils : lister, interroger, télécharger et envoyer des documents, miniatures, notes, étiquettes, correspondants, types de documents, champs personnalisés, ainsi que comptes et règles de courrier. Environ la moitié écrivent.
- Données et confidentialité
- Tout ce que le token d'API peut atteindre, suppression comprise. En mode HTTP depuis la v2.0.0, chaque requête doit porter son propre token Bearer, sauf si --no-auth est défini. Les envois par chemin de fichier lisent n'importe quel fichier local, sauf si PAPERLESS_MCP_UPLOAD_PATHS est défini. Aucun avis de sécurité GitHub n'est publié.
- Coût à grande échelle
- Gratuit ; Paperless-ngx est auto-hébergé, donc les seuls coûts sont votre serveur et les tokens du modèle. Les grandes pages de résultats et les envois en base64 sont les principales sources de contexte gonflé.
- Limites
- Paperless-ngx v3.0.0 rejette les versions de l'API inférieures à 9 avec HTTP 406. search_documents est déprécié au profit de query_documents. Les méthodes destructives en masse n'ont pas d'indicateur de confirmation.
Les points forts
- Environ 31 outils, dont les requêtes sur champs personnalisés et les règles de courrier
- Tokens Bearer par requête en mode HTTP depuis la v2.0.0
- npx et images Docker ; tests de bout en bout contre un vrai Paperless-ngx
- Activement maintenu, contrairement au dépôt d'origine
Les points faibles
- Suppression, fusion et scission en masse s'exécutent sans indicateur de confirmation
- Les envois par chemin de fichier ne sont pas restreints sans liste d'autorisation
- Un seul mainteneur ; environ 149 étoiles
- Les anciennes installations reçoivent HTTP 406 après Paperless-ngx 3.0
Idéal pour
Les utilisateurs de Paperless-ngx qui veulent qu'un agent trouve, étiquette et classe des documents et qui garderont les appels en écriture derrière des invites d'approbation.
Alternatives à Paperless-NGX MCP Server
Paperless-NGX MCP Server : questions fréquentes
- Paperless-NGX MCP Server vaut-il le coup ?
- Le serveur Paperless-ngx qui mérite d'être installé, assez complet pour assurer toute la journée d'un archiviste, et assez complet pour supprimer votre archive si vous le laissez faire. Nous lui donnons 3.8 sur 5.
- Combien coûte Paperless-NGX MCP Server ?
- Gratuit et open source (ISC). Paperless-ngx lui-même est gratuit et auto-hébergé.
- Quels sont les inconvénients de Paperless-NGX MCP Server ?
- Suppression, fusion et scission en masse s'exécutent sans indicateur de confirmation; les envois par chemin de fichier ne sont pas restreints sans liste d'autorisation; un seul mainteneur ; environ 149 étoiles; les anciennes installations reçoivent HTTP 406 après Paperless-ngx 3.0.
- À qui s’adresse Paperless-NGX MCP Server ?
- Les utilisateurs de Paperless-ngx qui veulent qu'un agent trouve, étiquette et classe des documents et qui garderont les appels en écriture derrière des invites d'approbation.
- Combien coûte Paperless-NGX MCP Server pour une équipe ou en production ?
- Gratuit ; Paperless-ngx est auto-hébergé, donc les seuls coûts sont votre serveur et les tokens du modèle. Les grandes pages de résultats et les envois en base64 sont les principales sources de contexte gonflé.
- Paperless-NGX MCP Server est-il sûr pour les données de l’entreprise ?
- Tout ce que le token d'API peut atteindre, suppression comprise. En mode HTTP depuis la v2.0.0, chaque requête doit porter son propre token Bearer, sauf si --no-auth est défini. Les envois par chemin de fichier lisent n'importe quel fichier local, sauf si PAPERLESS_MCP_UPLOAD_PATHS est défini. Aucun avis de sécurité GitHub n'est publié.
- Quelles sont les meilleures alternatives à Paperless-NGX MCP Server ?
- Les alternatives les plus proches que nous avons testées sont Filesystem (reference server), MarkItDown MCP et Zotero MCP.
Réponses vérifiées le 31 oct. 2026.