Shared Mailbox
access-shared-mailboxList emails or folders in a shared Outlook mailbox the signed-in user can access. Browse folder trees, read message details, or search a delegated mailbox (work/school accounts only).
Instructions
List emails or folders in a shared mailbox the signed-in user can access (read-only). Needs the server setting OUTLOOK_SHARED_MAILBOX (work/school only); while it is unset, every call is refused before any request to Microsoft Graph. Returns messages from sharedMailbox (alias email) and folder (default inbox) with id/subject/from/receivedDateTime/preview. folder takes a well-known name (inbox, sent, archive…), a custom/localized display name (e.g. Archiv), a nested path (e.g. Inbox/Vendors/Acme), or pass a raw folderId. listFolders: true enumerates the mailbox's folder tree (names, paths, IDs, counts). Needs the mailbox delegated to the signed-in user in Exchange (admin-configured). outputVerbosity sets field count and count (default 25, max 50) page size. search-emails with sharedMailbox searches and filters a shared mailbox.
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": "access-shared-mailbox"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of emails to retrieve (default: 25, max: 50) | |
| No | Alias for `sharedMailbox` (more intuitive name for the same value). | ||
| folder | No | Folder to read from (default: inbox). Accepts a well-known name, a custom/localized display name, or a nested path like `Inbox/Subfolder`. | |
| folderId | No | Exact Graph folder ID to read from (e.g. from `listFolders`). Skips name resolution; takes precedence over `folder`. | |
| listFolders | No | Enumerate the shared mailbox's full folder tree (names, paths, IDs, item counts) in place of reading messages. | |
| sharedMailbox | No | Email address of the shared mailbox (required) | |
| outputVerbosity | No | Output detail level (default: standard) |