list_mail_rules - Langmail

Lists the persistent mail rules with their ids, names, enabled state, matching conditions, ordered actions, and creation/modification times. Use it to answer “what rules do I have?”, to find the id for update_mail_rule or delete_mail_rule, or to check for an existing similar rule before creating a new one.

Parameters

None.

Example

Result

2 mail rule(s) — enabled rules apply automatically to incoming messages:

1. [rule-3f8a1c2e] Finance invoices
   when ALL of: sender contains "stripe.com" AND subject contains "invoice"
   then: move to "Finance"
   created: 2026-07-20T09:00:00.000Z

2. [rule-9b04d7aa] GitHub (paused) (disabled)
   when ALL of: sender contains "notifications@github.com"
   then: archive, then add tag "github"
   created: 2026-07-18T08:00:00.000Z, modified: 2026-07-22T12:00:00.000Z

With no rules configured the result is No mail rules configured. Create one with create_mail_rule (preview_mail_rule to dry-run it first).