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

# Outlook CLI

A command-line tool for managing Microsoft Outlook/Live/Hotmail emails via Microsoft Graph API. Built as an OpenClaw skill.

## Features

- 📧 **List emails** - View recent emails in your inbox
- 🔍 **Search** - Full-text search across emails
- 📖 **Read** - View full email content
- ✉️ **Send** - Send new emails with CC/BCC support
- 💬 **Reply** - Reply to emails (with reply-all support)

## Installation

### Prerequisites

- Python 3.7+
- `requests` library (`pip install requests`)

### Setup

1. **Clone or download** this repository:
   ```bash
   git clone https://github.com/abhiramee08b021/outlook-cli.git
   cd outlook-cli
   ```

2. **Create Azure AD App Registration:**
   - Go to [Azure Portal](https://portal.azure.com) → App registrations → New registration
   - Name: `outlook-cli` (or anything)
   - Supported account types: "Personal Microsoft accounts only"
   - Redirect URI: Web → `http://localhost:8080/callback`
   - Click **Register**

3. **Get credentials:**
   - Copy **Application (client) ID** from Overview page
   - Go to **Certificates & secrets** → New client secret → Copy value

4. **Configure the tool:**
   ```bash
   ./outlook configure
   # Enter your Client ID and Client Secret when prompted
   ```

5. **Authenticate:**
   ```bash
   ./outlook auth
   ```
   - Opens browser for Microsoft login
   - Copy the callback URL and paste when prompted

## Usage

### List Emails

```bash
./outlook list          # List 10 most recent emails
./outlook list 20       # List 20 emails
```

### Search Emails

```bash
./outlook search "from:linkedin.com"
./outlook search "subject:invoice"
./outlook search "body:meeting" 30
```

**Search operators:**
- `from:email@domain.com` - Search by sender
- `to:email@domain.com` - Search by recipient
- `subject:keyword` - Search subject line
- `body:keyword` - Search email body
- `received:YYYY-MM-DD` - Search by date
- `hasattachment:yes` - Emails with attachments

### Read Email

```bash
./outlook read...