m365-mailbox

name

m365-mailbox

description

MS365 / Microsoft365 mailbox automation via Microsoft Graph for Microsoft 365 (M365) Business (work/school, Exchange Online) and M365 Home/Consumer (hotmail.com, outlook.com, live.com). Use when listing unread emails, searching mail, reading messages, creating drafts, editing drafts, sending email, replying, forwarding, and troubleshooting Graph/MSAL device-code authentication for mailbox access. Related keywords: Outlook, Exchange Online, IMAP alternative, OneDrive, SharePoint, Teams (via Microsoft Graph), mail, inbox. Privacy note: no third-party API key required; authentication uses your own Microsoft login (device code) and tokens are stored locally per profile. **Token cost:** ~800-2k tokens per use (skill body ~3-4k tokens, Graph calls + parsing).

M365 Mailbox (Microsoft Graph)

Installation / runtime requirements

• Requires Node.js (scripts are Node ESM).
• This skill declares its npm dependency in package.json.
• After installing/updating the skill, install deps:

cd skills/m365-mailbox
npm install

Security / boundaries

• Never commit or share token caches.
• Default secret location (per machine): ~/.openclaw/secrets/m365-mailbox/

Setup philosophy (permission-aware)

During setup, the user chooses:

1. What Graph permissions to request (minimal vs broad)
2. What OpenClaw is allowed to do autonomously vs what must ask for confirmation

Two modes:

• Minimal-consent mode (more secure): request only the scopes required for the chosen feature set.
• Broad-consent mode (more flexible): request a superset of scopes, but enforce an autonomy policy locally.