# Outlook

> Microsoft Outlook/Live.com email client via Microsoft Graph API. List, search, read, send, and reply to emails.

- Skill: `demerzels-lab/outlook` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add demerzels-lab/outlook`
- Raw SKILL.md: https://api.skillmd.com/api/skills/demerzels-lab/outlook/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Demerzels-lab (https://skillmd.com/u/demerzels-lab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/demerzels-lab/outlook

---


# Outlook CLI

Command-line email client for Microsoft Outlook/Live/Hotmail using Microsoft Graph API.

## Setup

1. **Create Azure AD App:** https://portal.azure.com → App registrations
   - Name: `outlook-cli`
   - Account type: "Personal Microsoft accounts only"
   - Redirect URI: `http://localhost:8080/callback`

2. **Get credentials** from your app registration

3. **Configure:**
   ```bash
   outlook configure
   ```

4. **Authenticate:**
   ```bash
   outlook auth
   ```

## Commands

| Command | Description |
|---------|-------------|
| `outlook list [n]` | List recent emails |
| `outlook search "query" [n]` | Search emails |
| `outlook read <id>` | Read email by ID |
| `outlook send --to ...` | Send email |
| `outlook reply <id>` | Reply to email |
| `outlook status` | Check auth status |

## Examples

**List emails:**
```bash
outlook list 20
```

**Search:**
```bash
outlook search "from:linkedin.com"
outlook search "subject:invoice"
```

**Send:**
```bash
outlook send --to "user@example.com" --subject "Hello" --body "Message"
outlook send --to "a@x.com,b@x.com" --cc "boss@x.com" --subject "Update" --body-file ./msg.txt
```

**Reply:**
```bash
outlook reply EMAIL_ID --body "Thanks!"
outlook reply EMAIL_ID --all --body "Thanks everyone!"
```

## Search Operators

- `from:email@domain.com` - Sender
- `subject:keyword` - Subject line
- `body:keyword` - Email body
- `received:YYYY-MM-DD` - Date
- `hasattachment:yes` - Has attachments

## Files

- `SKILL.md` - This documentation
- `outlook` - Main CLI script
- `README.md` - Full documentation