# Outlook > Manage personal Microsoft 365 (Outlook.com/Hotmail/Live) email, calendar, and OneDrive via the m365-cli command-line tool. Requires: Node.js 18+ and `m365-cli` installed globally (`npm install -g m365-cli`), plus OAuth authentication (`m365 login --account-type personal`). Accesses sensitive data: emails, calendar events, OneDrive files, and contacts. Use when: (1) reading, sending, or searching emails, (2) managing calendar events (list, create, update, delete), (3) uploading/downloading OneDrive files, (4) searching users/people, (5) deleting or moving emails, (6) managing mail folders, (7) any task involving personal Outlook/Hotmail/Live account management from the terminal. Triggers: "check my email", "send an email", "schedule a meeting", "list my calendar", "upload to OneDrive", "download from OneDrive", "search mail", "what's on my calendar", "manage Outlook", "m365", "outlook", "delete email", "move email", "mail folders", "create folder", "organize email". - Skill: `dvcrn/outlook-2` (Agent Skill, multi-file: 7 files) - Install (CLI): `npx skillmds@latest add dvcrn/outlook-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/outlook-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector CAUTION) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Integrations & APIs - Author: dvcrn (https://skillmd.com/u/dvcrn) - Updated: 2026-09-09 - Page: https://skillmd.com/skills/dvcrn/outlook-2 --- # 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"`. ## 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 --force --json m365 mail send "to@example.com" "Subject" "Body" --json m365 mail send "to@example.com" "Subject" "Body" --attach file.pdf --cc "cc@ex.com" --json m365 mail search "keyword" --top 20 --json # Attachments m365 mail attachments --json m365 mail download-attachment [local-path] --json # Delete / move m365 mail delete --force --json m365 mail move --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 --force --json # Trusted senders whitelist m365 mail trusted --json m365 mail trust user@example.com m365 mail trust @example.com # Trust entire domain m365 mail untrust user@example.com ``` ### Calendar ```bash # List / get m365 cal list --days 7 --json m365 cal get --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 "a@ex.com,b@ex.com" --json m365 cal create "Holiday" --start "2026-03-20" --end "2026-03-21" --allday --json # Update / delete m365 cal update --title "New Title" --location "Room B" --json m365 cal delete --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 --force --json # 2. Read content m365 mail send "sender@ex.com" "Re: Sub" "Reply" --json # 3. Reply ``` ### 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 --json # 1. List attachments m365 mail download-attachment ~/Downloads/ --json # 2. Download ``` ### Delete and organize email ```bash m365 mail list --top 10 --json # 1. Find email m365 mail delete --force --json # 2a. Delete it, OR m365 mail move 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 --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.