document-crud-operations-via-mcp
Provides 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.
Unique: 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
vs alternatives: 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
Implements 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.
Unique: Integrates tag operations as discrete MCP tools, allowing LLM agents to dynamically create tags during classification workflows rather than requiring pre-populated tag lists
vs alternatives: 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
Provides 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.
Unique: 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
vs alternatives: More intelligent than manual correspondent assignment because agents can infer correspondents from document text and create records dynamically
document-type-classification-and-assignment
Implements 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.
Unique: Integrates document type assignment as an MCP tool, allowing LLM agents to classify documents into predefined categories as part of automated workflows
vs alternatives: Simpler than building custom classification models because it leverages Paperless-NGX's existing document type taxonomy
mcp-protocol-translation-and-tool-schema-mapping
Implements 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.
Unique: 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
vs alternatives: More maintainable than custom REST wrappers because MCP standardizes the interface contract between client and server
document-search-and-filtering-via-mcp
Provides 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.
Unique: 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
vs alternatives: 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
Provides 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.
Unique: Enables LLM agents to enrich document metadata through MCP tools, supporting partial updates that preserve existing data while adding AI-extracted information
vs alternatives: More intelligent than manual metadata entry because agents can extract and infer metadata from document content automatically
authentication-and-api-token-management
Implements 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.
Unique: Centralizes Paperless API authentication in the MCP server layer, preventing token exposure to individual MCP clients and enabling consistent security policies
vs alternatives: More secure than embedding tokens in client code because authentication is managed server-side and tokens never leave the MCP server process