📧 Outlook Mail

Search and read messages from Outlook inboxes

Source: openclaw-hub

outlook_inbox

List recent messages from the Outlook inbox, or any other mail folder.

Name Type Required Description
limit integer Optional Maximum number of messages to return (default 10).
unread boolean Optional Only show unread messages.
folder string Optional Mail folder to read (default: inbox). Well-known folder names: inbox, junkemail, deleteditems, sentitems, drafts, outbox, archive, clutter, conflicts, conversationhistory, localfailures, recoverableitemsdeletions, scheduled, searchfolders, serverfailures, syncissues.

Search Outlook messages by query text, sender, subject, or date range.

Name Type Required Description
query string Optional Full-text search across subject and body.
from string Optional Filter by sender email address.
subject string Optional Filter by subject (substring match).
since string Optional Only messages received on or after this date (YYYY-MM-DD).
before string Optional Only messages received on or before this date (YYYY-MM-DD).
limit integer Optional Maximum number of results (default 10).

outlook_read

Read a specific Outlook message by its ID, including full body content.

Name Type Required Description
message_id string Required The Microsoft Graph message ID to retrieve.

outlook_save_attachments

Download attachments from an Outlook message to a local directory. Also saves the message body as body.html. Useful for processing emails that contain inline images (e.g., USPS Informed Delivery).

Name Type Required Description
message_id string Required The Microsoft Graph message ID.
output_dir string Required Local directory path to save attachments to (created if needed).
content_types array Optional Content type filters (e.g. [‘image/’]). Defaults to [‘image/’].