@baruchiro/paperless-mcp

List Paperless mail accounts for selecting the account ID needed by mail rules. Does not expose account passwords.

Get one Paperless mail account by ID. Password/token fields are redacted if the server returns them.

Manually run Paperless mail processing for one account. This can consume matching mails according to enabled Paperless mail rules.

List Paperless mail rules with optional pagination.

Get one Paperless mail rule by ID.

Create a Paperless mail rule. Use list_mail_accounts first to choose account. Prefer attachment-only rules for invoices unless the full mail must be archived.

Patch an existing Paperless mail rule. Only supplied fields are changed.

Delete one Paperless mail rule. This changes future mail ingestion behavior but does not delete documents.

List all notes attached to a document. Notes are free-text comments on a document and are the natural place for an audit trail (e.g. \

Add a note to a document. Use this to record an audit trail or progress note directly on the document. Returns the document

⚠️ DESTRUCTIVE: Permanently delete a single note from a document by its note ID. This operation is irreversible. Returns the document

List all tags. IMPORTANT: When a user query may refer to a tag or document type, you should fetch all tags and all document types up front (with a large enough page_size), cache them for the session, and search locally for matches by name or slug before making further API calls. This reduces redundant requests and handles ambiguity between tags and document types efficiently.

Create a new tag with optional color, matching pattern, and matching algorithm for automatic document tagging.

Update an existing tag

⚠️ DESTRUCTIVE: Permanently delete a tag from the entire system. This will remove the tag from ALL documents that use it. Use with extreme caution.

Bulk edit tags. ⚠️ WARNING:

List all correspondents with optional filtering and pagination. Correspondents represent entities that send or receive documents.

Get a specific correspondent by ID with full details including matching rules.

Create a new correspondent with optional matching pattern and algorithm for automatic document assignment.

Update an existing correspondent

⚠️ DESTRUCTIVE: Permanently delete a correspondent from the entire system. This will affect ALL documents that use this correspondent.

Bulk edit correspondents. ⚠️ WARNING:

List all document types. IMPORTANT: When a user query may refer to a document type or tag, you should fetch all document types and all tags up front (with a large enough page_size), cache them for the session, and search locally for matches by name or slug before making further API calls. This reduces redundant requests and handles ambiguity between tags and document types efficiently.

Get a specific document type by ID with full details including matching rules.

Create a new document type with optional matching pattern and algorithm for automatic document classification.

Update an existing document type

⚠️ DESTRUCTIVE: Permanently delete a document type from the entire system. This will affect ALL documents that use this type.

Bulk edit document types. ⚠️ WARNING:

List all custom fields. IMPORTANT: When a user query may refer to a custom field, you should fetch all custom fields up front (with a large enough page_size), cache them for the session, and search locally for matches by name before making further API calls. This reduces redundant requests and handles ambiguity efficiently.

Get a specific custom field by ID with full details including data type and extra configuration.

Create a new custom field with a specified data type (string, url, date, boolean, integer, float, monetary, documentlink, or select). For monetary fields, values must use currency code prefix format (e.g., USD10.00, GBP123.45) — NOT trailing symbol format (e.g., 10.00$).

Update an existing custom field

⚠️ DESTRUCTIVE: Permanently delete a custom field from the entire system. This will remove the field from ALL documents that use it.

Bulk edit custom fields. ⚠️ WARNING:

Perform bulk operations on multiple documents. Note:

Upload a new document to Paperless-NGX with optional metadata like title, correspondent, document type, tags, and custom fields. Provide either

List and filter documents with pagination and common Paperless filters such as title search, correspondent, document type, tag, storage path, creation date, archive serial number, and simple custom field filters. Use

Query documents using the full-text query engine plus structured Paperless filters. Use this for complex filtering, custom field conditions, or any documented /api/documents/ query parameters that are not exposed as first-class arguments. Prefer the dedicated top-level arguments where available. custom_field_query supports [field_name_or_id, operator, value] leaves or [

Get a specific document by ID with full details including correspondent, document type, tags, and custom fields. Note: Document content is excluded from results by default. Use

Get the text content of a specific document by ID. Use this when you need to read or analyze the actual document text.

Deprecated compatibility wrapper for full-text document search. Use

Download a document file by ID. Returns a paperless:// resource URI; read the resource to fetch the file content.

Get a document thumbnail (image preview) by ID. Returns a paperless:// resource URI; read the resource to fetch the image content.

Update a specific document with new values (title, correspondent, document type, storage path, tags, custom fields, and more). Top-level fields you omit are left unchanged. IMPORTANT: custom_fields is the exception — see its parameter description; it replaces the document