Skip to main content
Glama
Softeria

Microsoft 365 MCP Server

by Softeria
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

update-mail-rule

update-mail-rule
Destructive

Update existing Microsoft 365 inbox rules by modifying conditions, actions, or enabled status. Send only the properties to change, like disabling a rule or altering its forwarding targets.

Instructions

Change writable properties on a messageRule object and save the changes.

šŸ’” TIP: Updates an existing message rule. Use the Inbox folder ID (get it from list-mail-folders) for inbox rules. Send only the properties to change. Common use: { isEnabled: false } to disable a rule, or update conditions/actions.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bodyYes
confirmNoFor destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.
mailFolderIdYesValue for the 'mailFolderId' path segment. Pass it under the name 'mailFolderId', not as 'id'. Use the 'id' field of the mail folder object as returned by Microsoft Graph.
messageRuleIdYesValue for the 'messageRuleId' path segment. Pass it under the name 'messageRuleId', not as 'id'. Use the 'id' field of the message rule object as returned by Microsoft Graph.
includeHeadersNoInclude response headers (including ETag) in the response metadata
excludeResponseNoExclude the full response body and only return success or failure indication

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed180 schema fields changedv0.145.2
    • removedInput schema / $defs
      Removed value: -{
-  "def0": {
-    "additionalProperties": true,
-    "properties": {
-      "emailAddress": {
-        "additionalProperties": true,
-        "properties": {
-          "address": {
-            "description": "The email address of the person or entity.",
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "name": {
-            "description": "The display name of the person or entity.",
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      }
-    },
-    "type": "object"
-  },
-  "def1": {
-    "enum": [
-      "low",
-      "normal",
-      "high"
-    ],
-    "type": "string"
-  },
-  "def10": {
-    "description": "Indicates whether an incoming message must be automatically forwarded in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def11": {
-    "description": "Indicates whether an incoming message must be an auto reply in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def12": {
-    "description": "Indicates whether an incoming message must be encrypted in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def13": {
-    "description": "Indicates whether an incoming message must be a meeting request in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def14": {
-    "description": "Indicates whether an incoming message must be a meeting response in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def15": {
-    "description": "Indicates whether an incoming message must be a non-delivery report in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def16": {
-    "description": "Indicates whether an incoming message must be permission controlled (RMS-protected) in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def17": {
-    "description": "Indicates whether an incoming message must be a read receipt in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def18": {
-    "description": "Indicates whether an incoming message must be S/MIME-signed in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def19": {
-    "description": "Indicates whether an incoming message must be a voice mail in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def2": {
-    "description": "Represents the strings that should appear in the body of an incoming message in order for the condition or exception to apply.",
-    "items": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "type": "array"
-  },
-  "def20": {
-    "enum": [
-      "any",
-      "call",
-      "doNotForward",
-      "followUp",
-      "fyi",
-      "forward",
-      "noResponseNecessary",
-      "read",
-      "reply",
-      "replyToAll",
-      "review"
-    ],
-    "type": "string"
-  },
-  "def21": {
-    "description": "Indicates whether the owner of the mailbox must not be a recipient of an incoming message in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def22": {
-    "description": "Represents the strings that appear in either the toRecipients or ccRecipients properties of an incoming message in order for the condition or exception to apply.",
-    "items": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "type": "array"
-  },
-  "def23": {
-    "description": "Represents the strings that appear in the from property of an incoming message in order for the condition or exception to apply.",
-    "items": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "type": "array"
-  },
-  "def24": {
-    "enum": [
-      "normal",
-      "personal",
-      "private",
-      "confidential"
-    ],
-    "type": "string"
-  },
-  "def25": {
-    "description": "Indicates whether the owner of the mailbox must be in the ccRecipients property of an incoming message in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def26": {
-    "description": "Indicates whether the owner of the mailbox must be the only recipient in an incoming message in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def3": {
-    "description": "Represents the strings that should appear in the body or subject of an incoming message in order for the condition or exception to apply.",
-    "items": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "type": "array"
-  },
-  "def4": {
-    "description": "Represents the categories that an incoming message should be labeled with in order for the condition or exception to apply.",
-    "items": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "type": "array"
-  },
-  "def5": {
-    "description": "Represents the specific sender email addresses of an incoming message in order for the condition or exception to apply.",
-    "items": {
-      "$ref": "#/$defs/def0"
-    },
-    "type": "array"
-  },
-  "def6": {
-    "description": "Indicates whether an incoming message must have attachments in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  },
-  "def7": {
-    "description": "Represents the strings that appear in the headers of an incoming message in order for the condition or exception to apply.",
-    "items": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "type": "array"
-  },
-  "def8": {
-    "$ref": "#/$defs/def1"
-  },
-  "def9": {
-    "description": "Indicates whether an incoming message must be an approval request in order for the condition or exception to apply.",
-    "type": [
-      "boolean",
-      "null"
-    ]
-  }
-}
    • removedInput schema / properties / body / properties / actions / properties / forwardAsAttachmentTo / items / $ref
      Removed value: -"#/$defs/def0"
    • addedInput schema / properties / body / properties / actions / properties / forwardAsAttachmentTo / items / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / actions / properties / forwardAsAttachmentTo / items / properties
      Added value: +{
+  "emailAddress": {
+    "additionalProperties": true,
+    "properties": {
+      "address": {
+        "description": "The email address of the person or entity.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "name": {
+        "description": "The display name of the person or entity.",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  }
+}
    • addedInput schema / properties / body / properties / actions / properties / forwardAsAttachmentTo / items / type
      Added value: +"object"
    • removedInput schema / properties / body / properties / actions / properties / forwardTo / items / $ref
      Removed value: -"#/$defs/def0"
    • addedInput schema / properties / body / properties / actions / properties / forwardTo / items / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / actions / properties / forwardTo / items / properties
      Added value: +{
+  "emailAddress": {
+    "additionalProperties": true,
+    "properties": {
+      "address": {
+        "description": "The email address of the person or entity.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "name": {
+        "description": "The display name of the person or entity.",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  }
+}
    • addedInput schema / properties / body / properties / actions / properties / forwardTo / items / type
      Added value: +"object"
    • removedInput schema / properties / body / properties / actions / properties / markImportance / $ref
      Removed value: -"#/$defs/def1"
    • addedInput schema / properties / body / properties / actions / properties / markImportance / enum
      Added value: +[
+  "low",
+  "normal",
+  "high"
+]
    • addedInput schema / properties / body / properties / actions / properties / markImportance / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / actions / properties / redirectTo / items / $ref
      Removed value: -"#/$defs/def0"
    • addedInput schema / properties / body / properties / actions / properties / redirectTo / items / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / actions / properties / redirectTo / items / properties
      Added value: +{
+  "emailAddress": {
+    "additionalProperties": true,
+    "properties": {
+      "address": {
+        "description": "The email address of the person or entity.",
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "name": {
+        "description": "The display name of the person or entity.",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "type": "object"
+  }
+}
    • addedInput schema / properties / body / properties / actions / properties / redirectTo / items / type
      Added value: +"object"
    • removedInput schema / properties / body / properties / conditions / properties / bodyContains / $ref
      Removed value: -"#/$defs/def2"
    • addedInput schema / properties / body / properties / conditions / properties / bodyContains / description
      Added value: +"Represents the strings that should appear in the body of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / bodyContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / conditions / properties / bodyContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / conditions / properties / bodyOrSubjectContains / $ref
      Removed value: -"#/$defs/def3"
    • addedInput schema / properties / body / properties / conditions / properties / bodyOrSubjectContains / description
      Added value: +"Represents the strings that should appear in the body or subject of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / bodyOrSubjectContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / conditions / properties / bodyOrSubjectContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / conditions / properties / categories / $ref
      Removed value: -"#/$defs/def4"
    • addedInput schema / properties / body / properties / conditions / properties / categories / description
      Added value: +"Represents the categories that an incoming message should be labeled with in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / categories / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / conditions / properties / categories / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / conditions / properties / fromAddresses / $ref
      Removed value: -"#/$defs/def5"
    • addedInput schema / properties / body / properties / conditions / properties / fromAddresses / description
      Added value: +"Represents the specific sender email addresses of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / fromAddresses / items
      Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "emailAddress": {
+      "additionalProperties": true,
+      "properties": {
+        "address": {
+          "description": "The email address of the person or entity.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "description": "The display name of the person or entity.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": "object"
+}
    • addedInput schema / properties / body / properties / conditions / properties / fromAddresses / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / conditions / properties / hasAttachments / $ref
      Removed value: -"#/$defs/def6"
    • addedInput schema / properties / body / properties / conditions / properties / hasAttachments / description
      Added value: +"Indicates whether an incoming message must have attachments in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / hasAttachments / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / headerContains / $ref
      Removed value: -"#/$defs/def7"
    • addedInput schema / properties / body / properties / conditions / properties / headerContains / description
      Added value: +"Represents the strings that appear in the headers of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / headerContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / conditions / properties / headerContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / conditions / properties / importance / $ref
      Removed value: -"#/$defs/def8"
    • addedInput schema / properties / body / properties / conditions / properties / importance / enum
      Added value: +[
+  "low",
+  "normal",
+  "high"
+]
    • addedInput schema / properties / body / properties / conditions / properties / importance / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / conditions / properties / isApprovalRequest / $ref
      Removed value: -"#/$defs/def9"
    • addedInput schema / properties / body / properties / conditions / properties / isApprovalRequest / description
      Added value: +"Indicates whether an incoming message must be an approval request in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isApprovalRequest / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isAutomaticForward / $ref
      Removed value: -"#/$defs/def10"
    • addedInput schema / properties / body / properties / conditions / properties / isAutomaticForward / description
      Added value: +"Indicates whether an incoming message must be automatically forwarded in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isAutomaticForward / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isAutomaticReply / $ref
      Removed value: -"#/$defs/def11"
    • addedInput schema / properties / body / properties / conditions / properties / isAutomaticReply / description
      Added value: +"Indicates whether an incoming message must be an auto reply in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isAutomaticReply / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isEncrypted / $ref
      Removed value: -"#/$defs/def12"
    • addedInput schema / properties / body / properties / conditions / properties / isEncrypted / description
      Added value: +"Indicates whether an incoming message must be encrypted in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isEncrypted / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isMeetingRequest / $ref
      Removed value: -"#/$defs/def13"
    • addedInput schema / properties / body / properties / conditions / properties / isMeetingRequest / description
      Added value: +"Indicates whether an incoming message must be a meeting request in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isMeetingRequest / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isMeetingResponse / $ref
      Removed value: -"#/$defs/def14"
    • addedInput schema / properties / body / properties / conditions / properties / isMeetingResponse / description
      Added value: +"Indicates whether an incoming message must be a meeting response in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isMeetingResponse / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isNonDeliveryReport / $ref
      Removed value: -"#/$defs/def15"
    • addedInput schema / properties / body / properties / conditions / properties / isNonDeliveryReport / description
      Added value: +"Indicates whether an incoming message must be a non-delivery report in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isNonDeliveryReport / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isPermissionControlled / $ref
      Removed value: -"#/$defs/def16"
    • addedInput schema / properties / body / properties / conditions / properties / isPermissionControlled / description
      Added value: +"Indicates whether an incoming message must be permission controlled (RMS-protected) in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isPermissionControlled / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isReadReceipt / $ref
      Removed value: -"#/$defs/def17"
    • addedInput schema / properties / body / properties / conditions / properties / isReadReceipt / description
      Added value: +"Indicates whether an incoming message must be a read receipt in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isReadReceipt / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isSigned / $ref
      Removed value: -"#/$defs/def18"
    • addedInput schema / properties / body / properties / conditions / properties / isSigned / description
      Added value: +"Indicates whether an incoming message must be S/MIME-signed in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isSigned / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / isVoicemail / $ref
      Removed value: -"#/$defs/def19"
    • addedInput schema / properties / body / properties / conditions / properties / isVoicemail / description
      Added value: +"Indicates whether an incoming message must be a voice mail in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / isVoicemail / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / messageActionFlag / $ref
      Removed value: -"#/$defs/def20"
    • addedInput schema / properties / body / properties / conditions / properties / messageActionFlag / enum
      Added value: +[
+  "any",
+  "call",
+  "doNotForward",
+  "followUp",
+  "fyi",
+  "forward",
+  "noResponseNecessary",
+  "read",
+  "reply",
+  "replyToAll",
+  "review"
+]
    • addedInput schema / properties / body / properties / conditions / properties / messageActionFlag / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / conditions / properties / notSentToMe / $ref
      Removed value: -"#/$defs/def21"
    • addedInput schema / properties / body / properties / conditions / properties / notSentToMe / description
      Added value: +"Indicates whether the owner of the mailbox must not be a recipient of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / notSentToMe / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / recipientContains / $ref
      Removed value: -"#/$defs/def22"
    • addedInput schema / properties / body / properties / conditions / properties / recipientContains / description
      Added value: +"Represents the strings that appear in either the toRecipients or ccRecipients properties of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / recipientContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / conditions / properties / recipientContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / conditions / properties / senderContains / $ref
      Removed value: -"#/$defs/def23"
    • addedInput schema / properties / body / properties / conditions / properties / senderContains / description
      Added value: +"Represents the strings that appear in the from property of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / senderContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / conditions / properties / senderContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / conditions / properties / sensitivity / $ref
      Removed value: -"#/$defs/def24"
    • addedInput schema / properties / body / properties / conditions / properties / sensitivity / enum
      Added value: +[
+  "normal",
+  "personal",
+  "private",
+  "confidential"
+]
    • addedInput schema / properties / body / properties / conditions / properties / sensitivity / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / conditions / properties / sentCcMe / $ref
      Removed value: -"#/$defs/def25"
    • addedInput schema / properties / body / properties / conditions / properties / sentCcMe / description
      Added value: +"Indicates whether the owner of the mailbox must be in the ccRecipients property of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / sentCcMe / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / conditions / properties / sentOnlyToMe / $ref
      Removed value: -"#/$defs/def26"
    • addedInput schema / properties / body / properties / conditions / properties / sentOnlyToMe / description
      Added value: +"Indicates whether the owner of the mailbox must be the only recipient in an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / conditions / properties / sentOnlyToMe / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / bodyContains / $ref
      Removed value: -"#/$defs/def2"
    • addedInput schema / properties / body / properties / exceptions / properties / bodyContains / description
      Added value: +"Represents the strings that should appear in the body of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / bodyContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / exceptions / properties / bodyContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / exceptions / properties / bodyOrSubjectContains / $ref
      Removed value: -"#/$defs/def3"
    • addedInput schema / properties / body / properties / exceptions / properties / bodyOrSubjectContains / description
      Added value: +"Represents the strings that should appear in the body or subject of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / bodyOrSubjectContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / exceptions / properties / bodyOrSubjectContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / exceptions / properties / categories / $ref
      Removed value: -"#/$defs/def4"
    • addedInput schema / properties / body / properties / exceptions / properties / categories / description
      Added value: +"Represents the categories that an incoming message should be labeled with in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / categories / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / exceptions / properties / categories / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / exceptions / properties / fromAddresses / $ref
      Removed value: -"#/$defs/def5"
    • addedInput schema / properties / body / properties / exceptions / properties / fromAddresses / description
      Added value: +"Represents the specific sender email addresses of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / fromAddresses / items
      Added value: +{
+  "additionalProperties": true,
+  "properties": {
+    "emailAddress": {
+      "additionalProperties": true,
+      "properties": {
+        "address": {
+          "description": "The email address of the person or entity.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "description": "The display name of the person or entity.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    }
+  },
+  "type": "object"
+}
    • addedInput schema / properties / body / properties / exceptions / properties / fromAddresses / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / exceptions / properties / hasAttachments / $ref
      Removed value: -"#/$defs/def6"
    • addedInput schema / properties / body / properties / exceptions / properties / hasAttachments / description
      Added value: +"Indicates whether an incoming message must have attachments in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / hasAttachments / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / headerContains / $ref
      Removed value: -"#/$defs/def7"
    • addedInput schema / properties / body / properties / exceptions / properties / headerContains / description
      Added value: +"Represents the strings that appear in the headers of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / headerContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / exceptions / properties / headerContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / exceptions / properties / importance / $ref
      Removed value: -"#/$defs/def8"
    • addedInput schema / properties / body / properties / exceptions / properties / importance / enum
      Added value: +[
+  "low",
+  "normal",
+  "high"
+]
    • addedInput schema / properties / body / properties / exceptions / properties / importance / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / exceptions / properties / isApprovalRequest / $ref
      Removed value: -"#/$defs/def9"
    • addedInput schema / properties / body / properties / exceptions / properties / isApprovalRequest / description
      Added value: +"Indicates whether an incoming message must be an approval request in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isApprovalRequest / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isAutomaticForward / $ref
      Removed value: -"#/$defs/def10"
    • addedInput schema / properties / body / properties / exceptions / properties / isAutomaticForward / description
      Added value: +"Indicates whether an incoming message must be automatically forwarded in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isAutomaticForward / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isAutomaticReply / $ref
      Removed value: -"#/$defs/def11"
    • addedInput schema / properties / body / properties / exceptions / properties / isAutomaticReply / description
      Added value: +"Indicates whether an incoming message must be an auto reply in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isAutomaticReply / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isEncrypted / $ref
      Removed value: -"#/$defs/def12"
    • addedInput schema / properties / body / properties / exceptions / properties / isEncrypted / description
      Added value: +"Indicates whether an incoming message must be encrypted in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isEncrypted / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isMeetingRequest / $ref
      Removed value: -"#/$defs/def13"
    • addedInput schema / properties / body / properties / exceptions / properties / isMeetingRequest / description
      Added value: +"Indicates whether an incoming message must be a meeting request in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isMeetingRequest / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isMeetingResponse / $ref
      Removed value: -"#/$defs/def14"
    • addedInput schema / properties / body / properties / exceptions / properties / isMeetingResponse / description
      Added value: +"Indicates whether an incoming message must be a meeting response in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isMeetingResponse / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isNonDeliveryReport / $ref
      Removed value: -"#/$defs/def15"
    • addedInput schema / properties / body / properties / exceptions / properties / isNonDeliveryReport / description
      Added value: +"Indicates whether an incoming message must be a non-delivery report in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isNonDeliveryReport / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isPermissionControlled / $ref
      Removed value: -"#/$defs/def16"
    • addedInput schema / properties / body / properties / exceptions / properties / isPermissionControlled / description
      Added value: +"Indicates whether an incoming message must be permission controlled (RMS-protected) in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isPermissionControlled / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isReadReceipt / $ref
      Removed value: -"#/$defs/def17"
    • addedInput schema / properties / body / properties / exceptions / properties / isReadReceipt / description
      Added value: +"Indicates whether an incoming message must be a read receipt in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isReadReceipt / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isSigned / $ref
      Removed value: -"#/$defs/def18"
    • addedInput schema / properties / body / properties / exceptions / properties / isSigned / description
      Added value: +"Indicates whether an incoming message must be S/MIME-signed in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isSigned / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / isVoicemail / $ref
      Removed value: -"#/$defs/def19"
    • addedInput schema / properties / body / properties / exceptions / properties / isVoicemail / description
      Added value: +"Indicates whether an incoming message must be a voice mail in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / isVoicemail / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / messageActionFlag / $ref
      Removed value: -"#/$defs/def20"
    • addedInput schema / properties / body / properties / exceptions / properties / messageActionFlag / enum
      Added value: +[
+  "any",
+  "call",
+  "doNotForward",
+  "followUp",
+  "fyi",
+  "forward",
+  "noResponseNecessary",
+  "read",
+  "reply",
+  "replyToAll",
+  "review"
+]
    • addedInput schema / properties / body / properties / exceptions / properties / messageActionFlag / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / exceptions / properties / notSentToMe / $ref
      Removed value: -"#/$defs/def21"
    • addedInput schema / properties / body / properties / exceptions / properties / notSentToMe / description
      Added value: +"Indicates whether the owner of the mailbox must not be a recipient of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / notSentToMe / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / recipientContains / $ref
      Removed value: -"#/$defs/def22"
    • addedInput schema / properties / body / properties / exceptions / properties / recipientContains / description
      Added value: +"Represents the strings that appear in either the toRecipients or ccRecipients properties of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / recipientContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / exceptions / properties / recipientContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / exceptions / properties / senderContains / $ref
      Removed value: -"#/$defs/def23"
    • addedInput schema / properties / body / properties / exceptions / properties / senderContains / description
      Added value: +"Represents the strings that appear in the from property of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / senderContains / items
      Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedInput schema / properties / body / properties / exceptions / properties / senderContains / type
      Added value: +"array"
    • removedInput schema / properties / body / properties / exceptions / properties / sensitivity / $ref
      Removed value: -"#/$defs/def24"
    • addedInput schema / properties / body / properties / exceptions / properties / sensitivity / enum
      Added value: +[
+  "normal",
+  "personal",
+  "private",
+  "confidential"
+]
    • addedInput schema / properties / body / properties / exceptions / properties / sensitivity / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / exceptions / properties / sentCcMe / $ref
      Removed value: -"#/$defs/def25"
    • addedInput schema / properties / body / properties / exceptions / properties / sentCcMe / description
      Added value: +"Indicates whether the owner of the mailbox must be in the ccRecipients property of an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / sentCcMe / type
      Added value: +[
+  "boolean",
+  "null"
+]
    • removedInput schema / properties / body / properties / exceptions / properties / sentOnlyToMe / $ref
      Removed value: -"#/$defs/def26"
    • addedInput schema / properties / body / properties / exceptions / properties / sentOnlyToMe / description
      Added value: +"Indicates whether the owner of the mailbox must be the only recipient in an incoming message in order for the condition or exception to apply."
    • addedInput schema / properties / body / properties / exceptions / properties / sentOnlyToMe / type
      Added value: +[
+  "boolean",
+  "null"
+]
  2. Addedv0.134.4
  3. Removedv0.131.2
  4. Changed1 schema field changedv0.131.1
    • addedInput schema / properties / confirm
      Added value: +{
+  "description": "For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: \"confirmation_required\" } without touching user data.",
+  "type": "boolean"
+}
  5. Addedv0.114.0
  6. Removedv0.112.2
  7. Addedv0.110.0
  8. Removedv0.108.0
  9. Addedv0.96.0

TDQS

A4.3/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already indicate this is a mutating/destructive action. The description adds useful behavioral context by explaining that this is a partial update ('send only the properties to change') and that only writable properties should be modified. It also gives a concrete example of disabling a rule, which helps the agent predict the mutation's effect.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loaded with the core action. The tip section is useful, though there is minor redundancy: 'Updates an existing message rule' largely restates 'Change writable properties on a messageRule object.' Overall, every major sentence earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex nested-body operation with no output schema, the description provides enough practical context: it explains partial update semantics, where to get the inbox folder ID, and shows a realistic minimal payload. It does not explain how the updated rule is returned, but the schema and annotations cover the input side well, and the operation is conventional.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is high at 83%, so the schema does the heavy lifting. The description still adds value by clarifying the body parameter semantics: send only changed properties, and provides a concrete common payload shape like { isEnabled: false }. It also gives guidance on sourcing the mailFolderId from list-mail-folders.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Change writable properties on a messageRule object and save the changes.' It also reinforces the intent by saying 'Updates an existing message rule,' which clearly distinguishes this from sibling tools like create-mail-rule, delete-mail-rule, and list-mail-rules.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides practical guidance: use the Inbox folder ID from list-mail-folders, send only the properties to change, and gives a common use case for disabling a rule. It does not explicitly say 'use create-mail-rule for new rules' or 'use delete-mail-rule for removal,' but 'existing message rule' implies this distinction clearly enough.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Softeria/ms-365-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server