# 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 archive. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3177/paperless-ngx-mcp

## Description

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.

## Health score

46/100 (Fair), based on 4 of 4 factors.
- Maintained: 79 (last commit 51 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 50 (2 GB minimum RAM)

## Links

- GitHub: https://github.com/paulmeier/paperless-ngx-mcp-container
- Unraid: https://ca.unraid.net/apps/paperless-ngx-mcp-08663es03m9xqg?q=Paperless-NGX-MCP

## 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.

## Alternatives

- 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…

---
Source: Our Local Host (https://ourlocalhost.com/app/3177/paperless-ngx-mcp), the self-hosted and open-source app directory.
