/install exchange-skills
Exchange Mail
Manage Microsoft Exchange/Outlook emails and calendar from terminal.
Script Location
scripts/exchange_mail.py - Main CLI script
Commands
# List unread (today, where you're To/CC)
python3 scripts/exchange_mail.py list
# List options
python3 scripts/exchange_mail.py list --days 3 # Last 3 days
python3 scripts/exchange_mail.py list --all # All unread
python3 scripts/exchange_mail.py list --json # JSON output
# Read email
python3 scripts/exchange_mail.py read \x3Cid>
# Reply
python3 scripts/exchange_mail.py reply \x3Cid> "Your message"
# Mark as read
python3 scripts/exchange_mail.py mark-read \x3Cid>
python3 scripts/exchange_mail.py mark-read --external
python3 scripts/exchange_mail.py mark-read --internal
python3 scripts/exchange_mail.py mark-read --all
# Archive
python3 scripts/exchange_mail.py archive \x3Cid>
python3 scripts/exchange_mail.py archive --external
python3 scripts/exchange_mail.py archive --internal --days 7
# Calendar (NEW!)
python3 scripts/exchange_mail.py calendar # Next 7 days
python3 scripts/exchange_mail.py calendar --today # Today only
python3 scripts/exchange_mail.py calendar --days 30 # Next 30 days
python3 scripts/exchange_mail.py calendar --json # JSON output
# Contacts (NEW!)
python3 scripts/exchange_mail.py contacts "name" # Search contacts
python3 scripts/exchange_mail.py contacts "name" --limit 10 # Limit results
python3 scripts/exchange_mail.py contacts "name" --json # JSON output
# Tasks (NEW!)
python3 scripts/exchange_mail.py tasks # List tasks
python3 scripts/exchange_mail.py tasks --days 30 # Next 30 days
python3 scripts/exchange_mail.py tasks --status pending # Filter by status
# Notes (NEW!)
python3 scripts/exchange_mail.py notes # List notes
python3 scripts/exchange_mail.py notes --limit 10 # Limit results
Note:
- Contact search requires access to Exchange contact folders. If no contacts are found, check folder permissions on the Exchange server.
- Tasks and Notes require the corresponding folders to exist in the Exchange account.
Email IDs
Each email gets stable 8-char hex ID (e.g., b7bc8d99). Use for all commands.
Output Format
📧 9 unread emails today:
━━━ Internal (4) ━━━
[b7bc8d99] [13:57] John Smith
Re: Project Discussion
━━━ External (5) ━━━
[43e56cc9] [09:50] [email protected]
Weekly Update
Batch Flags
--external- Only external emails (outside your domain)--internal- Only internal emails (your domain)--all- All emails--days N- Look back N days (default: today only)
Environment Variables
Required in shell config:
export EXCHANGE_SERVER="mail.company.com"
export EXCHANGE_EMAIL="[email protected]"
export EXCHANGE_USERNAME="username"
export EXCHANGE_PASSWORD="password"
Optional:
export EXCHANGE_DOMAIN="domain" # Windows domain if required
export EXCHANGE_DISABLE_SSL_VERIFY=1 # Only if you need to disable SSL verification (not recommended)
Note: The script will also load environment variables from a .env file in the script directory (skills/exchange-skills/scripts/.env) if it exists.
Workflow Examples
# Morning: check → read → reply → archive spam
python3 scripts/exchange_mail.py list
python3 scripts/exchange_mail.py read abc123
python3 scripts/exchange_mail.py reply abc123 "Thanks!"
python3 scripts/exchange_mail.py archive --external
# Weekly cleanup
python3 scripts/exchange_mail.py archive --external --days 7
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install exchange-skills - After installation, invoke the skill by name or use
/exchange-skills - Provide required inputs per the skill's parameter spec and get structured output
What is Exchange Skills?
Full email, calendar, contacts, tasks, and notes management for Microsoft Exchange/Outlook. Use when Claude needs to list unread emails, read email content,... It is an AI Agent Skill for Claude Code / OpenClaw, with 164 downloads so far.
How do I install Exchange Skills?
Run "/install exchange-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Exchange Skills free?
Yes, Exchange Skills is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Exchange Skills support?
Exchange Skills is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Exchange Skills?
It is built and maintained by Derek Hsu (@derekhsu); the current version is v1.0.2.