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

Clone or download this repository:

git clone https://github.com/abhiramee08b021/outlook-cli.git
cd outlook-cli

Create Azure AD App Registration:
- Go to Azure Portal → 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
Get credentials:
- Copy Application (client) ID from Overview page
- Go to Certificates & secrets → New client secret → Copy value

Configure the tool:

./outlook configure
# Enter your Client ID and Client Secret when prompted

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

Usage

List Emails

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

Search Emails

./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

./outlook read AQMkADAwATM3ZmY...

Send Email

# Simple email
./outlook send --to "recipient@example.com" --subject "Hello" --body "Message"
 
# Multiple recipients
./outlook send --to "user1@example.com,user2@example.com" --subject "Hi" --body "Hello all"
 
# With CC/BCC
./outlook send --to "boss@company.com" --cc "team@company.com" --subject "Update" --body "Project status"
 
# Body from file
./outlook send --to "friend@example.com" --subject "Notes" --body-file ./notes.txt
 
# HTML email
./outlook send --to "user@example.com" --subject "Styled" --body "<h1>Hello</h1>" --html
 
# From stdin (pipe)
echo "Meeting notes" | ./outlook send --to "team@company.com" --subject "Notes" --body-file -

Reply to Email

# Reply to sender only
./outlook reply EMAIL_ID --body "Thanks for the info!"
 
# Reply to all (includes CC)
./outlook reply EMAIL_ID --all --body "Thanks everyone!"
 
# Reply from file
./outlook reply EMAIL_ID --body-file ./response.txt

Check Status

./outlook status

Configuration

Configuration is stored in ~/.config/outlook-cli/:

config.json - Client ID and secret
tokens.json - OAuth tokens (auto-generated)

Security

Tokens are stored with restricted permissions (600)
Client secret is stored locally and never transmitted except to Microsoft
Uses OAuth2 with refresh tokens for secure, long-term access

Limitations

Attachments: Can view received emails with attachments, but sending attachments is not yet supported
Drafts: Direct send only, no draft saving

License

MIT

Contributing

Pull requests welcome! This is a community tool for Outlook email management.

Outlook-email