outlook-emails-lawvable
npx machina-cli add skill lawvable/awesome-legal-skills/outlook-emails-lawvable --openclawOutlook Email Integration (Read-Only)
Overview
| What this skill does | What it does NOT do |
|---|---|
| Read and search Outlook emails | Send emails |
| Download email attachments | Store any data between sessions |
| Integrate with other Skills (NDA, contracts) | Require any technical setup |
Getting Started
No configuration needed. Just run the skill and sign in with your Microsoft account.
Read emails
# Last 10 emails
uv run .agents/skills/outlook-emails-lawvable/scripts/outlook_oauth.py
# Last 5 emails
uv run .agents/skills/outlook-emails-lawvable/scripts/outlook_oauth.py --limit 5
Search emails
# Search by keyword
uv run .agents/skills/outlook-emails-lawvable/scripts/outlook_oauth.py --search "NDA"
# Search by sender
uv run .agents/skills/outlook-emails-lawvable/scripts/outlook_oauth.py --from "jean@example.com"
Download attachments
uv run .agents/skills/outlook-emails-lawvable/scripts/outlook_oauth.py --download
Authentication
Each run opens a browser window for Microsoft login. Sign in with your Microsoft account and accept the permissions.
Read-only access. The skill only requests permission to read your emails and your profile. It cannot send emails or modify anything.
Zero data retention. No token is stored between sessions. Each time you run the skill, you authenticate fresh. Nothing is cached on disk.
Your password is never shared with Lawvable.
Integration with Other Skills
Example: Email → NDA Review
User: "Read the latest email from jean@partner.com and review
the NDA attachment using the NDA skill"
Claude will:
1. Use outlook_oauth.py to fetch the email
2. Download the .docx attachment
3. Use nda-review-jamie-tso skill to analyze
4. Return the issue log with redlines
Advanced: Use Your Own Azure App
If you prefer to use your own Azure App Registration, set this environment variable:
AZURE_CLIENT_ID=your-client-id
See references/AZURE_SETUP.md for the full setup guide.
Source
git clone https://github.com/lawvable/awesome-legal-skills/blob/main/skills/outlook-emails-lawvable/SKILL.mdView on GitHub Overview
This skill enables reading, searching, and downloading Outlook emails and attachments through OAuth2. It supports integrating with other skills for tasks like NDA or contract review and enforces read-only access with zero data retention between sessions. It works with Microsoft Outlook, Office 365, or Exchange email accounts.
How This Skill Works
Authenticate via OAuth2 in a browser to grant read-only access to emails and profile data. The tool fetches emails and attachments, supports commands to limit results and search by keyword, sender, or subject, and returns results or downloads attachments for downstream skills.
When to Use It
- You need to check or fetch recent emails from a mailbox
- You want to search emails by keyword, sender, or subject
- You need to download an email attachment such as a contract or NDA
- You want to chain Outlook data into another skill like NDA review
- You require Outlook, Office 365, or Exchange access without sending emails
Quick Start
- Step 1: Sign in with your Microsoft account when prompted
- Step 2: Run read or search commands, for example limit 5 or search NDA
- Step 3: Run with the download option to fetch attachments and pass to other skills
Best Practices
- Operate in read-only mode to protect data
- Authenticate each session; no token is retained between sessions
- Use precise search terms to minimize results
- Download attachments only when needed and pass to downstream skills
- If using a custom Azure app, set AZURE_CLIENT_ID as described in the setup guide
Example Use Cases
- Read the last 10 emails in the inbox
- Search for emails containing NDA from a specific sender
- Download the NDA attachment for review
- Chain actions: read the latest email and pass the NDA to a review skill
- Connect with a personal Azure App by setting AZURE_CLIENT_ID
