manage-rules
Define and automate email processing by creating, updating, reordering, or deleting server-side inbox rules with customizable conditions, actions, and exceptions.
Instructions
Server-side inbox rule CRUD (destructive: covers delete; supports dryRun on create/update for preview). Rules run on the Exchange server regardless of which client is open. action=list (default) returns rules with id/name/sequence — pass includeDetails: true to expand conditions/actions/exceptions. action=create builds a new rule from condition params (12 supported: fromAddresses, containsSubject, bodyContains, hasAttachments, importance, sentTo, sensitivity, etc.), action params (9 supported: moveToFolder, forwardTo, redirectTo, assignCategories, markAsRead, delete, etc.), and optional except* exceptions. action=update patches the named fields by ruleId. action=reorder changes execution priority via sequence (lower = earlier). action=delete removes a rule. Recipient allowlist applies to forwardTo/redirectTo. permanentDelete action is intentionally omitted (too dangerous for AI use — use the Outlook UI). Subject to session rate limits (OUTLOOK_MAX_MANAGE_RULES_PER_SESSION).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Action to perform (default: list) | |
| includeDetails | No | Include detailed conditions, actions, and exceptions (action=list) | |
| name | No | Rule name (action=create required, action=update to rename) | |
| displayName | No | Alias for `name` (matches Graph's own `displayName` field). | |
| dryRun | No | Preview rule without creating/updating (action=create, action=update) | |
| isEnabled | No | Enable/disable rule (action=create default: true, action=update) | |
| sequence | No | Execution order, lower = higher priority (action=create default: auto, action=reorder required) | |
| fromAddresses | No | Comma-separated sender emails to match (action=create/update) | |
| containsSubject | No | Comma-separated subject keywords (OR logic). e.g. "invoice, receipt, payment" (action=create/update) | |
| bodyContains | No | Comma-separated body text keywords (OR logic) (action=create/update) | |
| bodyOrSubjectContains | No | Comma-separated keywords matching body OR subject (OR logic) (action=create/update) | |
| senderContains | No | Comma-separated partial sender matches (action=create/update) | |
| recipientContains | No | Comma-separated partial recipient matches (action=create/update) | |
| sentToAddresses | No | Comma-separated recipient emails to match (action=create/update) | |
| hasAttachments | No | Match emails with attachments (action=create/update) | |
| importance | No | Match emails with this importance (action=create/update) | |
| sensitivity | No | Match emails with this sensitivity (action=create/update) | |
| sentToMe | No | Match emails sent to me (action=create/update) | |
| sentOnlyToMe | No | Match emails where I am the only recipient (action=create/update) | |
| sentCcMe | No | Match emails where I am in CC (action=create/update) | |
| isAutomaticReply | No | Match automatic reply emails (action=create/update) | |
| moveToFolder | No | Folder name to move matching emails to (action=create/update) | |
| copyToFolder | No | Folder name to copy matching emails to (action=create/update) | |
| markAsRead | No | Mark matching emails as read (action=create/update) | |
| markImportance | No | Set importance on matching emails (action=create/update) | |
| forwardTo | No | Comma-separated emails to forward matching messages to (action=create/update) | |
| redirectTo | No | Comma-separated emails to redirect matching messages to (action=create/update) | |
| assignCategories | No | Comma-separated Outlook categories to assign (action=create/update) | |
| stopProcessingRules | No | Stop evaluating subsequent rules (action=create/update) | |
| deleteMessage | No | Move matching emails to Deleted Items (action=create/update) | |
| exceptFromAddresses | No | Comma-separated sender emails to exclude (action=create/update) | |
| exceptSubjectContains | No | Comma-separated subject keywords to exclude (action=create/update) | |
| exceptSenderContains | No | Comma-separated partial sender matches to exclude (action=create/update) | |
| exceptBodyContains | No | Comma-separated body keywords to exclude (action=create/update) | |
| exceptHasAttachments | No | Exclude emails with attachments (action=create/update) | |
| ruleName | No | Name of existing rule (action=update/reorder/delete) | |
| ruleId | No | ID of existing rule (action=update/delete) |