Skill: mrhah/outlookcli (version 1.1.0)

--- name: outlook description: >- Manage personal Microsoft account (Outlook.com / Hotmail / Live) email, calendar, and OneDrive via the m365-cli command-line tool. Use for personal email/calendar/OneDrive tasks — NOT for work/school accounts (use the m365-work skill) or SharePoint (personal accounts don't support it). required-binary: m365 requires.env: [] install: npm install -g m365-cli --- # Outlook Skill (m365-cli) Manage a personal Microsoft account (Outlook.com / Hotmail / Live) via the `m365` CLI. Use `--json` for structured output suitable for AI agent consumption (most commands support it). ## Prerequisites - Node.js 18+ - `m365-cli` installed globally: `npm install -g m365-cli` - Authenticated: `m365 login --account-type personal` If not authenticated, run login first. The CLI uses Device Code Flow — follow the on-screen URL and code. ## Key Conventions - **Use `--json`** for programmatic output (most commands support it; `trust`/`untrust` do not). - **Personal accounts** support: Mail (including delete, move, and folder management), Calendar, OneDrive, User search. **Not** SharePoint. - Calendar datetime format: `YYYY-MM-DDTHH:MM:SS` (local) or `YYYY-MM-DD` (all-day). - **IDs**: Email/event IDs are long opaque strings. Parse the `id` field from `--json` list/search output. - Timezone: auto-detected. Override: `export M365_TIMEZONE="Asia/Shanghai"`. ## Provenance - Source repo: `https://github.com/mrhah/m365-cli` - Package: `https://www.npmjs.com/package/m365-cli` - Publisher: `mrhah` - Required binary: `m365` from the `m365-cli` npm package ## Quick Workflow Reference ### Authentication ```bash m365 login --account-type personal # First-time login m365 logout # Clear credentials ``` ### Mail ```bash # List emails (folders: inbox|sent|drafts|deleted|junk) m365 mail list --top 10 --json m365 mail list --folder sent --top 5 --json m365 mail list --focused --json # Show only Focused Inbox emails # Read / send / search m365 mail read <id> --force --json m365 mail send "[REDACTED_SECRET]" "Subject" "Body" --json m365 mail send "[REDACTED_SECRET]" "Subject" "Body" --attach file.pdf --cc "[REDACTED_SECRET]" --json m365 mail search "keyword" --top 20 --json # Reply / reply-all / forward m365 mail reply <id> "content" --json m365 mail reply <id> "content" --attach file.pdf --json m365 mail reply-all <id> "content" --json m365 mail reply-all <id> "content" --attach a.pdf b.pdf --json m365 mail forward <id> "[REDACTED_SECRET]" "comment" --json m365 mail forward <id> "[REDACTED_SECRET]" "FYI" --attach report.pdf --json # Attachments m365 mail attachments <message-id> --json m365 mail download-attachment <message-id> <attachment-id> [local-path] --json # Delete / move m365 mail delete <id> --force --json m365 mail move <id> <destination> --json # destination: inbox|sent|drafts|deleted|junk|archive or folder ID # Folder management m365 mail folder list --json m365 mail folder list --parent inbox --json # List child folders m365 mail folder create "My Projects" --json m365 mail folder create "Sub" --parent inbox --json m365 mail folder delete <folder-id> --force --json # Trusted senders whitelist m365 mail trusted --json m365 mail trust [REDACTED_SECRET] m365 mail trust @example.com # Trust entire domain m365 mail untrust [REDACTED_SECRET] ``` ### Calendar ```bash # List / get m365 cal list --days 7 --json m365 cal get <event-id> --json # Create m365 cal create "Title" --start "2026-03-10T14:00:00" --end "2026-03-10T15:00:00" --json m365 cal create "Title" -s "2026-03-10T14:00:00" -e "2026-03-10T15:00:00" \ --location "Room A" --body "Notes" --attendees "[REDACTED_SECRET],[REDACTED_SECRET]" --json m365 cal create "Holiday" --start "2026-03-20" --end "2026-03-21" --allday --json # Update / delete m365 cal update <id> --title "New Title" --location "Room B" --json m365 cal delete <id> --json ``` ### OneDrive ```bash # List / get metadata m365 od ls --json m365 od ls Documents --json m365 od get "Documents/report.pdf" --json # Download / upload m365 od download "Documents/report.pdf" ~/Downloads/ --json m365 od upload ~/Desktop/photo.jpg "Photos/vacation.jpg" --json # Search / mkdir / delete m365 od search "budget" --top 20 --json m365 od mkdir "Projects/New" --json m365 od rm "old-file.txt" --force --json ``` For sharing, invitations, and advanced OneDrive options, see [references/commands.md](references/commands.md). ### User Search ```bash m365 user search "John" --top 5 --json # Searches contacts and people ``` ## Common Patterns ### Read and reply to email ```bash m365 mail list --top 5 --json # 1. Find email m365 mail read <id> --force --json # 2. Read content m365 mail reply <id> "Reply content" --json # 3. Reply ``` ### Reply with attachment ```bash m365 mail reply <id> "See attached" --attach report.pdf --json ``` ### Forward with attachment ```bash m365 mail forward <id> "[REDACTED_SECRET]" "FYI" --attach data.xlsx --json ``` ### Check calendar and schedule ```bash m365 cal list --days 3 --json # 1. Check availability m365 cal create "Meeting" -s "..." -e "..." --json # 2. Book slot ``` ### Download email attachment ```bash m365 mail attachments <msg-id> --json # 1. List attachments m365 mail download-attachment <msg-id> <att-id> ~/Downloads/ --json # 2. Download ``` ### Delete and organize email ```bash m365 mail list --top 10 --json # 1. Find email m365 mail delete <id> --force --json # 2a. Delete it, OR m365 mail move <id> archive --json # 2b. Move to archive ``` ### Manage mail folders ```bash m365 mail folder list --json # 1. List all folders m365 mail folder create "Projects" --json # 2. Create custom folder m365 mail move <id> <folder-id> --json # 3. Move email into it ``` ## Trusted Senders (Security) `m365 mail read` filters untrusted sender content (shows metadata only). Use `--force` to bypass. See [references/commands.md](references/commands.md#m365-mail-trust) for whitelist management commands. ## Full Command Reference See [references/commands.md](references/commands.md) for every command, subcommand, flag, and default value. ## Troubleshooting - **"Not authenticated"**: `m365 login --account-type personal` - **Token expired**: Auto-refreshes. If fails, re-run login. - **SharePoint errors**: Personal accounts don't support SharePoint. - **Wrong timezone**: `export M365_TIMEZONE="Your/Timezone"` ## Security & Privacy This skill accesses personal email, calendar, files, and contacts — all sensitive PII. - **Never** read, output, or log `~/.m365-cli/credentials.json` — it contains OAuth tokens. - **Never** include full email bodies or attachment contents in agent output unless the user explicitly requested that specific email. - **Summarize** email content instead of echoing it verbatim when presenting results to the user. - **Credential refresh** is automatic; never attempt to manually edit or parse the token file. - When listing emails, prefer showing metadata (subject, sender, date) over full body content.


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)