¿Qué es Paperless-NGX MCP Server?
Es el fork mantenido de nloui/paperless-mcp, el servidor MCP original para Paperless-ngx, cuyo último commit fue el 11 de noviembre de 2025. El fork de Baruch Rothkoff (baruchiro/paperless-mcp) tiene unas 149 estrellas en GitHub frente a las 248 del original, pero es el que sigue publicando: la v2.2.1 salió el 11 de septiembre de 2026, y su paquete npm tuvo 683 descargas en la semana hasta el 29 de octubre de 2026 frente a 171 del original.
Envuelve la API REST de Paperless-ngx con unas 31 herramientas que cubren documentos, notas, etiquetas, corresponsales, tipos de documento, campos personalizados y cuentas y reglas de correo. Funciona por stdio con npx -y @baruchiro/paperless-mcp@latest, o como imagen Docker que sirve Streamable HTTP y SSE en el puerto 3000. Necesita la URL de tu instancia de Paperless-ngx y un token de API de tu página de perfil. El repositorio tiene licencia ISC.
Cómo instalar Paperless-NGX MCP Server
npx -y @baruchiro/paperless-mcp@latest¿Merece la pena Paperless-NGX MCP Server?
Para quien ya guarda cartas, facturas y papeles de impuestos en Paperless-ngx, este servidor convierte el archivo en algo que un agente puede buscar y reorganizar. query_documents da acceso a la búsqueda de texto completo, a las búsquedas de documentos similares y a consultas estructuradas por campos personalizados, como encontrar todas las facturas sin número de factura. Eso cubre casi todo lo que una persona hace en la interfaz web.
La lista de herramientas va mucho más allá de leer. bulk_edit_documents puede fusionar, dividir y rotar documentos, borrar páginas o documentos enteros, y cambiar sus permisos; post_document sube archivos de hasta 100 MB; las herramientas de correo crean y editan las reglas que deciden qué extrae Paperless de tu bandeja de entrada. Solo el borrado de notas y de reglas de correo pide un indicador de confirmación explícito. Un borrado masivo no lo pide, así que el aviso de aprobación del cliente es la única protección.
El trabajo de seguridad del fork es la razón principal para elegirlo frente al original. La versión 2.0.0 hizo que el modo HTTP rechazara las peticiones sin token Bearer, cerrando un endpoint que antes recurría a la clave del propio servidor para cualquier cliente de la red. Ahora cada cliente HTTP envía su propio token de Paperless, así que los permisos de Paperless se aplican por usuario. Las subidas por ruta de archivo leen cualquier archivo que el proceso pueda ver salvo que PAPERLESS_MCP_UPLOAD_PATHS las restrinja, y esa variable es opcional.
Los puntos débiles son los habituales en un servidor comunitario de un solo mantenedor. Paperless-ngx v3.0.0 dejó de admitir las versiones de la API REST anteriores a la 9, y las configuraciones antiguas ven ahora errores HTTP 406 hasta que se define PAPERLESS_API_VERSION. La documentación es un README largo en lugar de un sitio de documentación. El texto de los documentos procedente de correo escaneado es una entrada no confiable, así que un agente que lo lee queda expuesto a inyección de prompts mientras tiene acceso de escritura al archivo.
Dónde se gana su sitio
Una autónoma con cinco años de facturas y recibos en Paperless-ngx
Encontrar todas las facturas de 2025 que aún no tienen número de factura antes de hacer la declaración
query_documents con una consulta por campo personalizado lista los huecos y bulk_edit_documents los etiqueta para revisarlos. Gratis sobre una instalación de Paperless ya existente; el coste son unas pocas llamadas a herramientas y revisar cada edición masiva.
Alguien con un home lab que escanea el correo postal de casa en Paperless
Configurar reglas de correo para que las facturas de suministros se extraigan del email y se etiqueten solas
El agente lista las cuentas de correo y luego llama a create_mail_rule con filtros de remitente y asunto y las etiquetas que asignar. Las contraseñas de las cuentas se ocultan en la salida de las herramientas, pero una regla equivocada puede marcar o mover correo en la bandeja real.
Una pequeña gestoría que autoaloja Paperless para los archivos de sus clientes
Dar a dos empleados un asistente que respete quién puede ver los documentos de cada cliente
Ejecuta la imagen Docker en modo HTTP y haz que cada cliente envíe su propio token de Paperless como cabecera Bearer, para que los permisos de Paperless se apliquen por persona. Mantén el servidor fuera de internet y no actives --no-auth.
Antes de decidirte
- Puesta en marcha
- Añade npx -y @baruchiro/paperless-mcp@latest con PAPERLESS_URL y PAPERLESS_API_KEY a la configuración del cliente, o ejecuta ghcr.io/baruchiro/paperless-mcp para HTTP y SSE en el puerto 3000. El README tiene un enlace de instalación para Cursor y un ejemplo para Continue; lleva unos minutos una vez que tienes un token.
- Integraciones
- Unas 31 herramientas: listar, consultar, descargar y subir documentos, miniaturas, notas, etiquetas, corresponsales, tipos de documento, campos personalizados, y cuentas y reglas de correo. Aproximadamente la mitad escriben.
- Datos y privacidad
- Todo lo que alcanza el token de API, borrado incluido. En modo HTTP, desde la v2.0.0, cada petición debe llevar su propio token Bearer salvo que se use --no-auth. Las subidas por ruta de archivo leen cualquier archivo local salvo que se defina PAPERLESS_MCP_UPLOAD_PATHS. No hay avisos de seguridad publicados en GitHub.
- Coste a escala
- Gratis; Paperless-ngx es autoalojado, así que los únicos costes son tu servidor y los tokens del modelo. Las páginas de resultados grandes y las subidas en base64 son las principales fuentes de contexto inflado.
- Límites
- Paperless-ngx v3.0.0 rechaza las versiones de la API anteriores a la 9 con HTTP 406. search_documents está obsoleta en favor de query_documents. Los métodos masivos destructivos no tienen indicador de confirmación.
Lo bueno
- Unas 31 herramientas, incluidas consultas por campos personalizados y reglas de correo
- Tokens Bearer por petición en modo HTTP desde la v2.0.0
- Imágenes npx y Docker; pruebas de extremo a extremo contra Paperless-ngx real
- Mantenido activamente, a diferencia del repositorio original
Lo malo
- El borrado, la fusión y la división masivos se ejecutan sin indicador de confirmación
- Las subidas por ruta de archivo no tienen restricción salvo que definas una lista permitida
- Un solo mantenedor; unas 149 estrellas
- Las configuraciones antiguas reciben HTTP 406 tras Paperless-ngx 3.0
Ideal para
Usuarios de Paperless-ngx que quieren que un agente encuentre, etiquete y archive documentos y que mantendrán las llamadas de escritura tras avisos de aprobación.
Alternativas a Paperless-NGX MCP Server
Paperless-NGX MCP Server: preguntas frecuentes
- ¿Merece la pena Paperless-NGX MCP Server?
- El servidor para Paperless-ngx que vale la pena instalar, lo bastante amplio para llevar la jornada entera de un archivista, y lo bastante amplio para borrar tu archivo si le dejas. Le damos un 3.8 sobre 5.
- ¿Cuánto cuesta Paperless-NGX MCP Server?
- Gratuito y de código abierto (ISC). Paperless-ngx también es gratuito y autoalojado.
- ¿Qué inconvenientes tiene Paperless-NGX MCP Server?
- El borrado, la fusión y la división masivos se ejecutan sin indicador de confirmación; las subidas por ruta de archivo no tienen restricción salvo que definas una lista permitida; un solo mantenedor; unas 149 estrellas; las configuraciones antiguas reciben HTTP 406 tras Paperless-ngx 3.0.
- ¿Para quién es Paperless-NGX MCP Server?
- Usuarios de Paperless-ngx que quieren que un agente encuentre, etiquete y archive documentos y que mantendrán las llamadas de escritura tras avisos de aprobación.
- ¿Cuánto cuesta Paperless-NGX MCP Server para un equipo o en producción?
- Gratis; Paperless-ngx es autoalojado, así que los únicos costes son tu servidor y los tokens del modelo. Las páginas de resultados grandes y las subidas en base64 son las principales fuentes de contexto inflado.
- ¿Es Paperless-NGX MCP Server seguro para los datos de la empresa?
- Todo lo que alcanza el token de API, borrado incluido. En modo HTTP, desde la v2.0.0, cada petición debe llevar su propio token Bearer salvo que se use --no-auth. Las subidas por ruta de archivo leen cualquier archivo local salvo que se defina PAPERLESS_MCP_UPLOAD_PATHS. No hay avisos de seguridad publicados en GitHub.
- ¿Cuáles son las mejores alternativas a Paperless-NGX MCP Server?
- Las alternativas más cercanas que hemos analizado son Filesystem (reference server), MarkItDown MCP y Zotero MCP.
Respuestas comprobadas el 31 oct 2026.