Model Context Protocol (MCP) server for interacting with Paperless-NGX document management system. Enables AI assistants to manage documents, tags, correspondents, and document types through the Paperless-NGX API.
Server has 17 tools with complete schemas and descriptions, but quality is uneven. Naming follows verb_noun convention well (list_, create_, bulk_edit_, post_, get_, search_, download_, update_, delete_). Descriptions are present but brief (avg ~60 chars, below 194-char baseline). Parameter descriptions exist but lack detail on constraints, formats, and dependencies. No output schemas documented. Error handling is minimal, no recovery guidance or categorization. Missing tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels. Bulk operations expose complex nested permission objects without clear guidance on structure.
Perform bulk operations on correspondents
Perform bulk operations on document types
Perform bulk operations on documents
Perform bulk operations on tags
Create a new correspondent in Paperless-NGX
Create a new document type in Paperless-NGX
Create a new tag in Paperless-NGX
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields (e.g., what fields does list_documents return? Does it include correspondent_id for chaining to create_correspondent?). Violates pattern:tool and pattern:response-shaper.
Bulk operation schemas expose deeply nested permission objects (view.users[], view.groups[], change.users[], change.groups[]) without clear documentation of structure, required fields, or examples. LLMs will struggle to construct valid payloads. Violates pattern:constrained-input.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, REVERSIBLE, IRREVERSIBLE, DESTRUCTIVE). Agents cannot distinguish safe from dangerous operations without reading descriptions. Violates pattern:tool-annotation.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Delete a tag from Paperless-NGX
Download a document from Paperless-NGX
Get details of a specific document from Paperless-NGX
List all correspondents from Paperless-NGX
List all document types from Paperless-NGX
List documents from Paperless-NGX with optional pagination
List all tags from Paperless-NGX
Upload a new document to Paperless-NGX
Search for documents in Paperless-NGX
Update an existing tag in Paperless-NGX
Descriptions are too brief (avg ~60 chars vs 194-char baseline). Missing WHEN to use each tool, prerequisites, and dependencies. E.g., bulk_edit_documents description does not explain that 'method' determines which optional parameters apply. Violates pattern:tool-description.
No error handling guidance. Responses do not categorize errors as retryable, user-fixable, or fatal. No recovery hints (e.g., 'User not found. Try search_users() first.'). Violates pattern:recovery-guide and pattern:error-classification.