PaperlessMCP
PaperlessMCP is an MCP server. It reaches paperless. It needs PAPERLESS_API_TOKEN to authenticate. Its repository has 46 GitHub stars and is licensed under MIT; we last read it on 2026-10-23.
Serves Model Context Protocol (MCP) for integration with Paperless-ngx document management system.
Install
Read from PaperlessMCP’s own README, close to verbatim -- not written by us, and not guessed.
docker run -d --name paperless-mcp --restart unless-stopped -e PAPERLESS_BASE_URL=https://your-paperless.example.com -e PAPERLESS_API_TOKEN=your-token-here -p 5000:5000 -v paperless-outbox:/home/mcp/outbox ghcr.io/barryw/paperlessmcp:vX.Y.Z
What it reaches, and what it needs
Reaches
paperless
Credential
PAPERLESS_API_TOKEN
Maintenance
Stars
46
State
listed
Licence
MIT
From the repository
A Model Context Protocol (MCP) server for Paperless-ngx document management
What PaperlessMCP can do
40 tools documented in its README. An AI client calls these by name.
paperless_documents_search- Find documents with full-text search and filters
paperless_documents_get- No description in the README.
paperless_documents_upload- Upload a document (base64)
paperless_documents_upload_from_path- Upload from a file path
paperless_documents_update- Update title, tags, correspondent, etc.
paperless_documents_delete- Delete a document (requires confirmation)
paperless_documents_bulk_update- Update multiple documents at once
paperless_documents_download- Get download, preview and thumbnail URLs; optionally inline tiny files as base64
paperless_documents_export_to_outbox- Write a document's file into the shared outbox directory so another tool can attach it by path
paperless_documents_preview- Get preview URL
paperless_documents_thumbnail- Get thumbnail URL
paperless_documents_reprocess- Re-run OCR on a document
paperless_tags_list- No description in the README.
paperless_tags_get- No description in the README.
paperless_tags_create- Create a tag with optional color, matching rules, and parent
paperless_tags_update- Update a tag, including changing or clearing its parent
paperless_tags_delete- Delete a tag
paperless_tags_bulk_delete- Delete multiple tags
paperless_correspondents_list- No description in the README.
paperless_correspondents_get- No description in the README.
paperless_correspondents_create- Create with optional matching rules
paperless_correspondents_update- Update a correspondent
paperless_correspondents_delete- Delete a correspondent
paperless_correspondents_bulk_delete- Delete multiple correspondents
paperless_document_types_list- No description in the README.
paperless_document_types_get- No description in the README.
paperless_document_types_create- Create with optional matching rules
paperless_document_types_update- Update a document type
paperless_document_types_delete- Delete a document type
paperless_document_types_bulk_delete- Delete multiple document types
paperless_storage_paths_list- No description in the README.
paperless_storage_paths_get- No description in the README.
paperless_storage_paths_create- Create with path template
paperless_storage_paths_update- Update a storage path
paperless_storage_paths_delete- Delete a storage path
paperless_storage_paths_bulk_delete- Delete multiple storage paths
paperless_custom_fields_list- No description in the README.
paperless_custom_fields_get- No description in the README.
paperless_custom_fields_create- Create a field (string, date, number, monetary, etc.)
paperless_custom_fields_update- Update a field definition
Read from the README; names are kept only if the README contains them.
Common questions about PaperlessMCP
- What does PaperlessMCP do?
- Serves Model Context Protocol (MCP) for integration with Paperless-ngx document management system.
- How do I install PaperlessMCP?
- Its own README gives this command: docker run -d --name paperless-mcp --restart unless-stopped -e PAPERLESS_BASE_URL=https://your-paperless.example.com -e PAPERLESS_API_TOKEN=your-token-here -p 5000:5000 -v paperless-outbox:/home/mcp/outbox ghcr.io/barryw/paperlessmcp:vX.Y.Z. Run it where your MCP client can launch the server, and check the README for any settings it asks for.
- What does PaperlessMCP connect to, and what does it need?
- It reaches paperless. The credentials we found in its source are PAPERLESS_API_TOKEN.
- Is PaperlessMCP official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 46 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-10-11.
- What licence does PaperlessMCP use?
- The repository declares the MIT licence.