{"passport":{"unfragile":{"@version":"1.0","version":"2026-05","artifact":{"id":"awesome-paperless-mcp","slug":"paperless-mcp","name":"Paperless-MCP","type":"mcp","url":"https://github.com/baruchiro/paperless-mcp","page_url":"https://unfragile.ai/paperless-mcp","categories":["mcp-servers","documentation"],"tags":[],"pricing":{"model":"open_source","free":true,"starting_price":null},"status":"active","verified":false},"capabilities":[{"id":"awesome-paperless-mcp__cap_0","uri":"capability://tool.use.integration.document.crud.operations.via.mcp","name":"document-crud-operations-via-mcp","description":"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.","intents":["I want to programmatically create new documents in my Paperless instance from an LLM agent","I need to retrieve document details and metadata to display in a chat interface","I want to update document properties like title and notes through an AI workflow","I need to delete documents based on criteria determined by an LLM"],"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"],"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"],"requires":["Paperless-NGX instance with REST API enabled","Valid API token for Paperless-NGX authentication","MCP-compatible client (Claude, Cline, or other MCP consumer)","Network connectivity to Paperless-NGX server"],"input_types":["JSON-serialized document metadata (title, notes, created_date)","document ID (integer)","query parameters for filtering"],"output_types":["JSON document objects with full metadata","HTTP status codes and error messages","document ID on creation"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-paperless-mcp__cap_1","uri":"capability://tool.use.integration.tag.management.and.assignment","name":"tag-management-and-assignment","description":"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.","intents":["I want to automatically tag documents based on their content analysis by an LLM","I need to create new tags programmatically when they don't exist in my Paperless instance","I want to list all available tags to present options to users in a chat interface","I need to bulk-assign multiple tags to a document based on AI classification"],"best_for":["developers building AI-powered document classification systems","teams automating document tagging workflows with LLM agents","users wanting to organize Paperless documents through conversational AI"],"limitations":["No tag hierarchy or parent-child relationships — tags are flat, limiting organizational depth","Tag deletion not supported — only creation and assignment available","No tag merging capability — duplicate tags cannot be consolidated programmatically","Tag color/icon customization limited to Paperless-NGX's predefined palette"],"requires":["Paperless-NGX instance with tag management API endpoints","Valid API token with tag management permissions","MCP client with tool-calling capability"],"input_types":["tag name (string)","document ID (integer)","tag color/icon specification (optional)"],"output_types":["JSON tag objects with ID, name, color","list of all tags in instance","confirmation of tag assignment"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-paperless-mcp__cap_2","uri":"capability://tool.use.integration.correspondent.management.and.linking","name":"correspondent-management-and-linking","description":"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.","intents":["I want to automatically identify the sender of a document and link it to a correspondent record","I need to create new correspondent entries when processing documents from unknown sources","I want to list all correspondents to help users filter documents by sender","I need to bulk-assign documents to correspondents based on email address or name extraction"],"best_for":["teams managing multi-source document workflows with automated sender identification","developers building email-to-Paperless integration with correspondent auto-linking","organizations wanting conversational access to correspondent-based document filtering"],"limitations":["No email address validation or deduplication — duplicate correspondents with similar names can be created","Correspondent deletion not supported — only creation and assignment","No bulk correspondent operations — each assignment requires separate API call","Contact information fields limited to what Paperless-NGX schema supports"],"requires":["Paperless-NGX instance with correspondent API endpoints","Valid API token with correspondent management permissions","MCP client capable of tool calling"],"input_types":["correspondent name (string)","document ID (integer)","contact metadata (optional)"],"output_types":["JSON correspondent objects with ID and name","list of all correspondents","confirmation of correspondent assignment"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-paperless-mcp__cap_3","uri":"capability://tool.use.integration.document.type.classification.and.assignment","name":"document-type-classification-and-assignment","description":"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.","intents":["I want to automatically classify documents into document types based on content analysis","I need to list available document types to understand what categories exist in my instance","I want to assign the correct document type to documents as part of an ingestion workflow","I need to filter documents by type through a conversational interface"],"best_for":["developers building document classification pipelines with LLM agents","teams automating document type assignment in Paperless workflows","organizations wanting AI-powered document categorization"],"limitations":["Document type creation not supported — only assignment to predefined types","No custom document type definitions — limited to types pre-configured in Paperless-NGX","No hierarchical document types — all types are flat categories","Document type deletion not available through MCP interface"],"requires":["Paperless-NGX instance with document type API endpoints","Pre-configured document types in Paperless-NGX instance","Valid API token with document type management permissions","MCP client with tool-calling capability"],"input_types":["document ID (integer)","document type ID (integer)"],"output_types":["JSON document type objects with ID and name","list of all available document types","confirmation of type assignment"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-paperless-mcp__cap_4","uri":"capability://tool.use.integration.mcp.protocol.translation.and.tool.schema.mapping","name":"mcp-protocol-translation-and-tool-schema-mapping","description":"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.","intents":["I want to use Paperless-NGX with Claude or other MCP clients without writing custom integrations","I need a standardized protocol layer between my LLM agent and Paperless API","I want to ensure my Paperless operations follow MCP best practices and standards","I need proper error handling and authentication management for Paperless API calls"],"best_for":["developers integrating Paperless-NGX with MCP-compatible LLM clients","teams standardizing on MCP for document management integrations","organizations wanting protocol-compliant AI agent integrations"],"limitations":["MCP protocol overhead adds ~50-100ms latency per tool call compared to direct REST","Tool schema validation happens on both MCP and Paperless sides, creating redundant checks","No connection pooling for Paperless API — each tool call creates new HTTP connection","Error messages from Paperless API may not map cleanly to MCP error schema"],"requires":["MCP-compatible client implementation (Claude, Cline, etc.)","Paperless-NGX instance with REST API enabled","Valid API token for Paperless-NGX","Network connectivity between MCP server and Paperless instance"],"input_types":["MCP tool call requests with JSON parameters","authentication tokens"],"output_types":["MCP tool result responses with JSON content","MCP error responses with error codes and messages"],"categories":["tool-use-integration","automation-workflow"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-paperless-mcp__cap_5","uri":"capability://search.retrieval.document.search.and.filtering.via.mcp","name":"document-search-and-filtering-via-mcp","description":"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.","intents":["I want to search for documents by title or content keywords through a chat interface","I need to filter documents by multiple criteria (tag, correspondent, type) in a single query","I want to retrieve a paginated list of documents matching specific conditions","I need to find documents created within a date range for reporting or analysis"],"best_for":["developers building conversational document search interfaces","teams automating document retrieval workflows with LLM agents","users wanting natural language search over their Paperless library"],"limitations":["Full-text search limited to Paperless-NGX's built-in search capabilities — no custom indexing","No relevance ranking or scoring — results returned in database order","Pagination requires manual offset/limit management — no cursor-based pagination","Search performance degrades with large document sets (>100k documents)"],"requires":["Paperless-NGX instance with search API endpoints","Valid API token with document read permissions","MCP client with tool-calling capability"],"input_types":["search query string (text)","filter parameters (tag IDs, correspondent IDs, document type IDs)","pagination parameters (offset, limit)","date range filters (optional)"],"output_types":["JSON array of matching document objects","total count of matching documents","pagination metadata"],"categories":["search-retrieval","tool-use-integration"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-paperless-mcp__cap_6","uri":"capability://tool.use.integration.document.metadata.enrichment.and.bulk.updates","name":"document-metadata-enrichment-and-bulk-updates","description":"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.","intents":["I want to update document titles based on content analysis by an LLM","I need to add notes or descriptions to documents programmatically","I want to correct document creation dates based on extracted information","I need to bulk-update metadata for multiple documents in a workflow"],"best_for":["developers building document enrichment pipelines with LLM agents","teams automating metadata correction workflows","organizations wanting AI-powered document annotation"],"limitations":["No transaction support — partial failures leave some documents updated and others unchanged","Bulk updates require separate API calls per document — no batch endpoint","No audit trail for metadata changes — cannot track who/when changes occurred","Field validation depends on Paperless-NGX schema — invalid values rejected without helpful error messages"],"requires":["Paperless-NGX instance with document update API endpoints","Valid API token with document write permissions","MCP client with tool-calling capability"],"input_types":["document ID (integer)","metadata fields to update (title, notes, created_date)","new values for fields"],"output_types":["JSON updated document object","confirmation of update with timestamp"],"categories":["tool-use-integration","data-processing-analysis"],"confidence":0.5,"matches":0,"success_rate":0},{"id":"awesome-paperless-mcp__cap_7","uri":"capability://tool.use.integration.authentication.and.api.token.management","name":"authentication-and-api-token-management","description":"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.","intents":["I want to securely authenticate my MCP client with Paperless-NGX without exposing API tokens","I need to manage API token lifecycle and permissions for different MCP operations","I want to ensure all Paperless API calls are properly authenticated and authorized","I need to handle token expiration and refresh transparently"],"best_for":["developers building secure Paperless integrations with LLM agents","teams managing multi-user access to Paperless through MCP","organizations with strict API security requirements"],"limitations":["Token storage depends on MCP client implementation — no built-in secure storage","No fine-grained permission management — tokens grant all-or-nothing access","Token rotation not automated — requires manual regeneration in Paperless","No audit logging of API access through MCP layer"],"requires":["Paperless-NGX API token (generated in Paperless admin interface)","MCP client with environment variable or configuration file support","Network connectivity to Paperless-NGX instance"],"input_types":["API token (string)","Paperless-NGX server URL"],"output_types":["authenticated HTTP requests to Paperless API","authorization status and error messages"],"categories":["tool-use-integration","safety-moderation"],"confidence":0.5,"matches":0,"success_rate":0}],"trust":{"score":31,"verified":false,"data_access_risk":"high","permissions":["Paperless-NGX instance with REST API enabled","Valid API token for Paperless-NGX authentication","MCP-compatible client (Claude, Cline, or other MCP consumer)","Network connectivity to Paperless-NGX server","Paperless-NGX instance with tag management API endpoints","Valid API token with tag management permissions","MCP client with tool-calling capability","Paperless-NGX instance with correspondent API endpoints","Valid API token with correspondent management permissions","MCP client capable of tool calling"],"failure_modes":["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","No tag merging capability — duplicate tags cannot be consolidated programmatically","Tag color/icon customization limited to Paperless-NGX's predefined palette","No email address validation or deduplication — duplicate correspondents with similar names can be created","Correspondent deletion not supported — only creation and assignment","builder identity is not verified yet","no observed match outcomes yet"],"rank_breakdown":{"adoption":0.05,"quality":0.41,"ecosystem":0.49999999999999994,"match_graph":0.25,"freshness":0.52,"weights":{"adoption":0.25,"quality":0.25,"ecosystem":0.15,"match_graph":0.23,"freshness":0.12}},"observed_outcomes":{"matches":0,"success_rate":0,"avg_confidence":0,"top_intents":[],"last_matched_at":null},"maintenance":{"status":"active","updated_at":"2026-06-17T09:51:03.579Z","last_scraped_at":"2026-05-03T14:00:15.503Z","last_commit":null},"community":{"stars":null,"forks":null,"weekly_downloads":null,"model_downloads":null,"model_likes":null}},"distribution":{"claim_url":"https://unfragile.ai/submit?claim=paperless-mcp","compare_url":"https://unfragile.ai/compare?artifact=paperless-mcp"}},"signature":"/FatYa71HUoA31iV08Gz/pSRRooABP/m3mKdyuTmEO44FxMPm9wqIs4yMca87Cp8z+mcgqXULqEyue61I7jmAQ==","signedAt":"2026-06-22T06:38:20.541Z","signedBy":"unfragile.ai","version":1},"_links":{"self":"https://unfragile.ai/api/v1/passport/paperless-mcp","artifact":"https://unfragile.ai/paperless-mcp","verify":"https://unfragile.ai/api/v1/verify?slug=paperless-mcp","publicKey":"https://unfragile.ai/api/v1/trust-passport-public-key","spec":"https://unfragile.ai/trust","schema":"https://unfragile.ai/schema.json","docs":"https://unfragile.ai/docs"}}