Paperless-NGX MCP

Paperless-NGX MCP is a Model Context Protocol (MCP) server that lets AI assistants and other MCP clients search, read, and manage documents in a Paperless-NGX…

  • AI
  • Network Services
  • Productivity
  • Tools & Utilities
Paperless-NGX MCP is a Model Context Protocol (MCP) server that lets AI assistants and other MCP clients search, read, and manage documents in a Paperless-NGX archive. It is a headless container for self-hosters who want scoped MCP tools instead of raw API calls.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

46/100 Fair

Maintained
79last commit 51 days ago
Popular
00 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
502 GB minimum RAM

Availability: platform listings confirmed today, links checked 19 days ago

GitHub stars
0
Open issues
0
Last commit
2026-10-01
Latest release
v3.2.1
License
MIT
Activity
stale

Checked 6 days ago - source: GitHub (paulmeier/paperless-ngx-mcp-container)

Resources & Compatibility

Minimum requirements: 2 GB RAM.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Start it with Docker Compose Run docker compose up -d in the folder that has your compose file to start Paperless in the background. Without this, the app is not running, and it won't come back by itself after a reboot. source
  • Keep your document folders safe Paperless needs the 'consume' folder for dropping in new documents and the 'media' folder for storing processed files. If those folders are missing or not backed up, you can lose your documents and attachments. source
  • Optional: add startup scripts You can mount a folder of setup scripts to /custom-cont-init.d so the container runs them when it starts. Use this only if you need extra packages or custom fixes; otherwise you can skip it. source
  • Connect to Paperless-NGX Requires a reachable Paperless-NGX instance and an API token; point MCP clients to the streamable HTTP endpoint on port 3000 at /mcp. source

Fetched 47 days ago - each note links to its source

Alternatives (10)

  • Genius Scan - Genius Scan is a scanner in your pocket.
  • Mayan EDMS - Mayan EDMS is a web-based open-source electronic document management system that helps individuals and teams organize, index, and share doc…
  • Paperless-ngx - Paperless-ngx is a self-hosted document management system that converts scanned and digital documents into a searchable archive using optic…
  • Papermerge - Papermerge is an open-source document management system that archives, organizes, and retrieves digital documents from scanner uploads and…
  • Paperwork - Paperwork is a personal document manager for scanned documents (and PDFs).
  • Papra - Papra is a lightweight, self-hosted document management and archiving platform that automatically imports, stores, and organises files for…
  • Teedy - Teedy is an open-source, lightweight document management system for individuals and small businesses that provides optical character recogn…
  • docspell - Docspell assists in organizing your piles of digital documents, resulting from scanners, e-mails and other sources with minimal effort.
  • ecodms - EcoDMS is an audit-compliant document management system for self-hosted users that scans, stores, manages, and retrieves data and documents…
  • paperless-ng - Paperless-ng is an archived self-hosted document management system for homelab users that indexes scanned documents, stores metadata, and m…

Checked 40 days ago - source: AlternativeTo

Common questions

Do I have to clone the repository to run the container?

No, you only need the docker-compose.yml and .env files. The compose file pulls the prebuilt image, so cloning the whole repo is optional.

Which Paperless values must be set in the .env file?

Set PAPERLESS_URL to your Paperless-NGX base URL and PAPERLESS_API_KEY to your Paperless API token. The token is found under Settings, user menu, API Token in Paperless.

Which endpoint do HTTP-capable MCP clients use?

The HTTP transport listens on port 3000 at the /mcp path by default. Point the MCP client at that streamable-HTTP endpoint.

How do I use it with a client that launches a server through stdio?

Run the container in interactive mode with MCP_TRANSPORT set to stdio. No port needs to be published for stdio clients.

How do I control which upstream MCP server version is installed?

Use a version tag such as 0.1.6 to get that exact upstream release. The latest tag tracks the newest upstream release, while broader tags follow a patch or minor line.

Answers sourced from github.com

Community

Collected 49 days ago - public community threads