Paperless-MCP
MCP ServerFree** - An MCP server for interacting with a Paperless-NGX API server. This server provides tools for managing documents, tags, correspondents, and document types in your Paperless-NGX instance.
Capabilities8 decomposed
document-crud-operations-via-mcp
Medium confidenceProvides MCP-compliant tool endpoints for creating, reading, updating, and deleting documents in a Paperless-NGX instance. Implements REST-to-MCP protocol translation, mapping Paperless API document endpoints to standardized MCP tool schemas with JSON request/response serialization. Handles document metadata (title, notes, created date) and file associations through the Paperless-NGX REST API.
Exposes Paperless-NGX as native MCP tools rather than requiring custom API wrappers, enabling direct integration with Claude and other MCP clients without intermediate HTTP layer abstraction
Simpler than building custom REST clients for each LLM framework because MCP standardizes the tool schema and protocol, reducing boilerplate integration code
tag-management-and-assignment
Medium confidenceImplements MCP tools for creating, listing, and assigning tags to documents within Paperless-NGX. Translates tag operations into REST API calls, supporting tag creation with custom colors/icons and bulk tag assignment to documents. Maintains tag hierarchy and relationships through the Paperless API's tag endpoint structure.
Integrates tag operations as discrete MCP tools, allowing LLM agents to dynamically create tags during classification workflows rather than requiring pre-populated tag lists
More flexible than static tag lists because agents can create new tags on-demand when classification requires categories not yet in the system
correspondent-management-and-linking
Medium confidenceProvides MCP tools for managing correspondents (senders/recipients) in Paperless-NGX, including creation, listing, and assignment to documents. Implements REST API translation for correspondent endpoints, enabling LLM agents to identify and link document sources to correspondent records. Supports correspondent metadata like name and contact information.
Exposes correspondent operations as MCP tools, enabling LLM agents to extract sender information from document content and automatically create/link correspondent records without manual intervention
More intelligent than manual correspondent assignment because agents can infer correspondents from document text and create records dynamically
document-type-classification-and-assignment
Medium confidenceImplements MCP tools for managing document types (categories like invoices, receipts, contracts) in Paperless-NGX, including listing available types and assigning them to documents. Translates document type operations into REST API calls, enabling LLM agents to classify documents into predefined categories. Supports document type metadata and filtering.
Integrates document type assignment as an MCP tool, allowing LLM agents to classify documents into predefined categories as part of automated workflows
Simpler than building custom classification models because it leverages Paperless-NGX's existing document type taxonomy
mcp-protocol-translation-and-tool-schema-mapping
Medium confidenceImplements the core MCP server protocol handler that translates between MCP tool calls and Paperless-NGX REST API requests. Manages tool schema definitions, request/response serialization, error handling, and protocol compliance. Handles authentication token management and API endpoint routing for all Paperless operations through standardized MCP tool interfaces.
Implements full MCP server protocol compliance with Paperless-NGX API translation, handling tool schema registration, request routing, and error mapping in a single cohesive layer
More maintainable than custom REST wrappers because MCP standardizes the interface contract between client and server
document-search-and-filtering-via-mcp
Medium confidenceProvides MCP tools for searching and filtering documents in Paperless-NGX using query parameters, tags, correspondents, and document types. Translates search criteria into REST API filter parameters, enabling LLM agents to retrieve documents matching specific criteria. Supports pagination and result limiting for large document sets.
Exposes Paperless-NGX search as MCP tools with multi-criteria filtering, allowing LLM agents to compose complex queries through tool parameters rather than query string parsing
More flexible than simple keyword search because agents can combine multiple filter dimensions (tags, correspondents, types) in a single query
document-metadata-enrichment-and-bulk-updates
Medium confidenceProvides MCP tools for updating document metadata fields (title, notes, created date) in bulk or individually. Implements REST API translation for document update endpoints, enabling LLM agents to enrich document records with extracted or inferred information. Supports partial updates without overwriting unspecified fields.
Enables LLM agents to enrich document metadata through MCP tools, supporting partial updates that preserve existing data while adding AI-extracted information
More intelligent than manual metadata entry because agents can extract and infer metadata from document content automatically
authentication-and-api-token-management
Medium confidenceImplements secure authentication handling for Paperless-NGX API access through MCP, managing API token storage, validation, and request signing. Translates MCP client requests into authenticated Paperless API calls with proper authorization headers. Handles token refresh and expiration management if supported by Paperless-NGX.
Centralizes Paperless API authentication in the MCP server layer, preventing token exposure to individual MCP clients and enabling consistent security policies
More secure than embedding tokens in client code because authentication is managed server-side and tokens never leave the MCP server process
Capabilities are decomposed by AI analysis. Each maps to specific user intents and improves with match feedback.
Related Artifactssharing capabilities
Artifacts that share capabilities with Paperless-MCP, ranked by overlap. Discovered automatically through the match graph.
Couchbase
** - Interact with the data stored in Couchbase clusters using natural language.
atlas-mcp-server
A Model Context Protocol (MCP) server for ATLAS, a Neo4j-powered task management system for LLM Agents - implementing a three-tier architecture (Projects, Tasks, Knowledge) to manage complex workflows. Now with Deep Research.
MongoDB MCP Server
Query and manage MongoDB databases and collections via MCP.
Zapier
** - Connect your AI Agents to 8,000 apps instantly.
@benborla29/mcp-server-mysql
MCP server for interacting with MySQL databases with write operations support
MongoDB Lens
** - Full Featured MCP Server for MongoDB Database.
Best For
- ✓developers building LLM agents that manage document libraries
- ✓teams automating document ingestion workflows with Claude or other MCP-compatible clients
- ✓solo developers integrating Paperless-NGX with AI-powered document management systems
- ✓developers building AI-powered document classification systems
- ✓teams automating document tagging workflows with LLM agents
- ✓users wanting to organize Paperless documents through conversational AI
- ✓teams managing multi-source document workflows with automated sender identification
- ✓developers building email-to-Paperless integration with correspondent auto-linking
Known Limitations
- ⚠No batch document operations — each CRUD action requires a separate MCP call, adding latency for bulk operations
- ⚠Document file upload/download not supported — only metadata operations available
- ⚠No transaction support — partial failures in multi-step document operations leave inconsistent state
- ⚠Rate limiting depends entirely on underlying Paperless-NGX API configuration
- ⚠No tag hierarchy or parent-child relationships — tags are flat, limiting organizational depth
- ⚠Tag deletion not supported — only creation and assignment available
Requirements
Input / Output
UnfragileRank
UnfragileRank is computed from adoption signals, documentation quality, ecosystem connectivity, match graph feedback, and freshness. No artifact can pay for a higher rank.
About
** - An MCP server for interacting with a Paperless-NGX API server. This server provides tools for managing documents, tags, correspondents, and document types in your Paperless-NGX instance.
Categories
Alternatives to Paperless-MCP
Are you the builder of Paperless-MCP?
Claim this artifact to get a verified badge, access match analytics, see which intents users search for, and manage your listing.
Get the weekly brief
New tools, rising stars, and what's actually worth your time. No spam.
Data Sources
Looking for something else?
Search →