Paperless MCP Server
Overview
A stateless Model Context Protocol server that gives Claude direct access to a Paperless-ngx instance. Instead of switching between a chat window and a document management UI, you ask Claude to find, tag, or inspect your documents and it does so through MCP tool calls.
The server exposes three tool groups — document operations, tag management, and metadata queries — over a single HTTP endpoint. Each request spins up a fresh MCP transport and tears it down on close, keeping the server entirely stateless.
Architecture
- Transport: StreamableHTTPServerTransport — stateless, one transport per request
- Tools: Document search and retrieval, tag CRUD, metadata and correspondent queries
- Client: Typed wrapper around the Paperless-ngx REST API with token authentication
- Deployment: Designed to run alongside Paperless-ngx in Docker Compose
Stack
TypeScript · MCP SDK · Express 5 · Paperless-ngx API