Repository navigation
v3.2.0
Aligns the tool surface with Paperless-ngx 3.2 and drops support for older Paperless versions.
Fixed
- Workflow actions could not express 4 of the 8 action types.
create_workflow_action/update_workflow_actionnow accept types 5 (password removal), 6 (move to trash), 7 (remote OCR) and 8 (apply AI suggestions) with their fields (passwords,ai_suggestion_fields,ai_create_missing,ai_overwrite_existing), plusassign_custom_fields_valuesand the per-item removal lists (remove_correspondents,remove_document_types,remove_storage_paths,remove_owners,remove_view_*,remove_change_*). - Workflow triggers used the legacy singular filters. Triggers now take the any/all/not forms the web UI writes (
filter_has_all_tags,filter_has_not_tags,filter_has_any_*/filter_has_not_*for correspondents, document types and storage paths) andfilter_custom_field_query.matching_algorithmis limited to 0–5, the range triggers support. list_documentsdocumented acustom_field_querysyntax Paperless rejects. The description now gives the JSON expression syntax (["Amount", "gte", 100],["AND", […]]).- Paperless error details were dropped. Validation errors (
{"non_field_errors": ["password not specified"]}) and plain-text errors ("AI is required for this feature") now appear in the tool error instead of a bare "status code 400" — for every JSON API call and for version uploads;post_documentuploads still report only the status. HTML error pages are still reduced to the status line. - A slow Paperless response could leave a tool call hanging until the MCP client gave up. Every JSON API call now has a 90-second overall deadline and fails with a message naming the endpoint. Downloads are exempt.
list_taskslimitabove 25 returned only 25 tasks; it is now passed to the server as the page size.list_trashreturned the full text of every trashed document, which could overflow the model's context. Content is now left out, as inlist_documents.
Added
- Workflows:
list_workflows,get_workflow,create_workflow,update_workflow,delete_workflow. A workflow, with its nested triggers and actions, is what Paperless actually runs; standalone triggers and actions do nothing on their own (and Paperless deletes unattached ones whenever a workflow is updated).get_workflowoutput can be edited and sent straight back toupdate_workflow;create_workflowignores nested ids, so copying a workflow never takes over the original's triggers. Webhook actions gainas_jsonandinclude_document. - Document versions:
upload_document_version(reports the document'sdocument_idand the newversion_id),update_document_version,delete_document_version,merge_documents_as_versions. edit_documents_bulk: methodremove_password(withupdate_document: truethe unlocked file becomes a new version),remote_ocrfor methodreprocess, andall+filters(+excluded_documents) to select every matching document, e.g. to reassign all documents of a duplicate correspondent in one call. Filter keys Paperless would silently ignore (which would select every document) are refused, invalid values are caught by a preview query, and the result reportsmatched_documents.list_documents:has_duplicatesfilter.- Mail:
list/get/create/update/delete_mail_account,test_mail_account(pass a saved account'sidto test it with its stored password),process_mail_account,list/get/create/update/delete_mail_rule. - Share link bundles:
list/get/create/rebuild/delete_share_link_bundle(s). - System:
get_system_status(includes the Paperless version),get_document_ai_suggestions,list_active_tasks,get_task_status_counts,get_task_summary.list_tasksacceptstask_type: apply_ai_suggestions. get_documentnow explains which fields follow the latest version (content, metadata) and which describe the root (page_count, file names).- Distribution: the release workflow now also publishes a Docker image to
ghcr.io/cubinet-code/paperless-ngx-mcp(linux/amd64 and linux/arm64; stdio by default,--httpfor Streamable HTTP), attaches a Claude Desktop extension (paperless-ngx-mcp.mcpb) to each GitHub Release, and lists the server in the official MCP Registry asio.github.cubinet-code/paperless-ngx-mcp.
Changed (BREAKING)
- Paperless-ngx 2.x is no longer supported. The 2.x compatibility code (task status casing fallback, flat
/tasks/arrays,related_document/result) is gone. Stay on3.1.1for Paperless 2.x. list_tasksdropped the 2.x-only filterstask_nameandtype. Usetask_typeandtrigger_source.update_share_linkwas removed. Paperless has never allowed editing a share link (the endpoint only supports GET and DELETE), so every call failed with HTTP 405. Delete and recreate the link instead.- Workflow triggers no longer accept
filter_has_correspondent/filter_has_document_type. Usefilter_has_any_correspondents/filter_has_any_document_types. edit_documents_bulkdocumentsis optional whenall: true+filtersis given. Exactly one of the two selection forms is required.
Security
- Workflow PDF passwords no longer reach the model in clear text.
list_workflows,get_workflow,list_workflow_actions,get_workflow_actionand the create/update results show the passwords of password-removal actions as**********. Sending the masked list back toupdate_workflow/update_workflow_actionkeeps the stored passwords; creating an action from masked passwords is refused. @modelcontextprotocol/sdk1.30.0→1.30.1(caps JSON-RPC batches at 100 messages) and in-range transitive bumps fromnpm audit fix:fast-uri3.1.5→3.1.8(high: host confusion via skipped IDN canonicalization),hono4.13.1→4.13.8andqs6.15.3→6.16.0(moderate).npm auditis clean.
Full Changelog: v3.1.1...v3.2.0