Mailbox Settings
mailbox-settingsRead or update mailbox-level settings, including automatic replies and working hours, with dry-run previews before changes apply.
Instructions
Read or update mailbox-level settings (idempotent — safe to retry; sets are PATCH-style and merge with existing state). action=get (default) returns settings — use section to filter (language, timeZone, workingHours, automaticRepliesSetting, or all). action=set-auto-replies configures out-of-office: enabled true/false, optional startDateTime/endDateTime (ISO 8601) for scheduled mode, internalReplyMessage and (optionally) externalReplyMessage and externalAudience (none/contactsOnly/all); pass dryRun: true to preview who would get replies without changing anything. action=set-working-hours updates the schedule: startTime/endTime (HH:MM) and daysOfWeek (array of monday..sunday). Returns the updated settings object on set actions.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "mailbox-settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Action to perform (default: get) | |
| dryRun | No | Preview only (action=set-auto-replies): nothing is changed. Shows who would get automatic replies, the schedule and each message length. Other actions refuse dryRun and change nothing. Default false. | |
| enabled | No | Enable (true) or disable (false) automatic replies (action=set-auto-replies) | |
| endTime | No | Work end time in HH:MM format, e.g. '17:00' (action=set-working-hours) | |
| section | No | Specific section to retrieve (action=get, default: all) | |
| timeZone | No | Time zone name, e.g. 'Australia/Melbourne' (action=set-working-hours) | |
| startTime | No | Work start time in HH:MM format, e.g. '09:00' (action=set-working-hours) | |
| daysOfWeek | No | Work days, e.g. ['monday','tuesday','wednesday','thursday','friday'] (action=set-working-hours) | |
| endDateTime | No | End date/time for scheduled mode, ISO 8601 format (action=set-auto-replies) | |
| startDateTime | No | Start date/time for scheduled mode, ISO 8601 format (action=set-auto-replies) | |
| externalAudience | No | Who receives external reply (action=set-auto-replies) | |
| externalReplyMessage | No | Reply message for external senders (action=set-auto-replies) | |
| internalReplyMessage | No | Reply message for internal senders (action=set-auto-replies) |