Show current Microsoft auth configuration and cached accounts.

When running inside the MCP Lambda wrapper framework, reports framework-managed authentication status instead of local MSAL state.

Start Microsoft authentication.

In Lambda mode, returns an OAuth authorization URL. In local mode, starts the device-code flow.

Complete Microsoft authentication after user approval.

In Lambda mode, this is not needed — call auth_status instead. In local mode, completes the device-code flow.

List mail folders. Pass parent_folder_id to list subfolders (check child_folder_count to know if subfolders exist).

List recent mail messages from a folder, newest first.

Pass since (ISO-8601) to filter server-side to messages received at or after that time. Pass fields to override the selected columns (id is always included) for a leaner or extended payload. Each summary includes conversation_id for threading without a follow-up fetch.

Get a full read-only view of a specific mail message.

Update message properties: read/unread, follow-up flag (flagged/complete/notFlagged), or color categories.

Move a message to another folder. Requires Mail.ReadWrite permission.

Delete a message or move it to Deleted Items. Requires Mail.ReadWrite permission.

Search messages using Microsoft Graph message search.

Bulk-manage messages with filtering. Supports dry-run, delete, move, and mark-read actions.

By default (limit=None) this scans the entire folder newest-first, so "find/act on all messages matching X" sees the whole folder, not a window. Pass limit only to cap how many messages are scanned (e.g. limit=200 scans at most the newest 200); the value is honored exactly, never silently clamped. Filtering is client-side.

The response reports coverage honestly: truncated is False only when the scan reached the end of the folder (stop_reason="folder_exhausted"), so a match count is a true total; if limit cut the scan short it is True. The mailbox is live, so counts are a point-in-time snapshot. Collection and action are separate phases; messages moved or deleted between them are reported as already_gone, not errors.

List readable calendars. Pass user_id for shared calendars (e.g. another user's email or object ID).

List events from a calendar in a time range. Pass user_id for shared calendars.

Get full details for a specific calendar event. Pass user_id for shared calendars.

Compose and send an email (no attachments). Defaults to dry-run (preview only). Set dry_run=False to actually send. To send with attachments, use create_draft + add_attachment_to_draft + manage_draft instead.

Reply to a message. Defaults to dry-run (preview only). Set dry_run=False to actually send.

Forward a message. Defaults to dry-run (preview only). Set dry_run=False to actually send.

Create a draft email (saved to Drafts folder). Use this when you need to add attachments before sending, or want to build a message over multiple steps. Then use manage_draft to send.

Update and/or send a previously created draft. Provide fields to update, set send=True to send. Use after create_draft and optionally add_attachment_to_draft.

Get attachments for a message. Without attachment_id: list all metadata. With attachment_id: download that attachment (base64 if under 1.5 MB).

Attach a file (base64-encoded) to a draft message.

Create a new mail folder, optionally under a parent folder.

List email aliases (send-from addresses) for the authenticated user.

Create a new calendar event. Pass user_id for shared calendars.

Update an existing calendar event. Pass user_id for shared calendars.

Delete or cancel a calendar event. Pass user_id for shared calendars.

Respond to a meeting invite. Pass user_id for shared calendars.

Check calendar availability. mode='free_busy': get free/busy schedule. mode='suggest': suggest meeting times.

Search for people by name to find their email addresses.