Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Use when the user asks about emails, inbox, Outlook, Microsoft mail, calendar e...
Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Use when the user asks about emails, inbox, Outlook, Microsoft mail, calendar e...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Access Outlook/Hotmail email and calendar via Microsoft Graph API using OAuth2.
# Requires: Azure CLI, jq ./scripts/outlook-setup.sh The setup script will: Log you into Azure (device code flow) Create an App Registration automatically Configure API permissions (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite) Guide you through authorization Save credentials to ~/.outlook-mcp/
See references/setup.md for step-by-step manual configuration via Azure Portal.
You can connect multiple Outlook accounts (personal, work, etc.):
./scripts/outlook-setup.sh --account work ./scripts/outlook-setup.sh --account personal
./scripts/outlook-mail.sh --account work inbox ./scripts/outlook-calendar.sh --account personal today ./scripts/outlook-token.sh --account work refresh
export OUTLOOK_ACCOUNT=work ./scripts/outlook-mail.sh inbox
./scripts/outlook-token.sh list Credentials are stored separately: ~/.outlook-mcp/ default/ config.json credentials.json work/ config.json credentials.json Existing single-account setups are auto-migrated to default.
./scripts/outlook-token.sh refresh # Refresh expired token ./scripts/outlook-token.sh test # Test connection ./scripts/outlook-token.sh get --confirm # Print access token (requires confirmation)
./scripts/outlook-mail.sh inbox [count] # List latest emails (default: 10) ./scripts/outlook-mail.sh unread [count] # List unread emails ./scripts/outlook-mail.sh search "query" [count] # Search emails (KQL syntax) ./scripts/outlook-mail.sh from <email> [count] # List emails from sender ./scripts/outlook-mail.sh read <id> # Read email content ./scripts/outlook-mail.sh attachments <id> # List email attachments
# Date range filters ./scripts/outlook-mail.sh query --after 2024-01-01 --before 2024-01-31 # Folder + unread filter ./scripts/outlook-mail.sh query --folder Inbox --unread --count 50 # Sender + attachments filter ./scripts/outlook-mail.sh query --from boss@work.com --has-attachments # Combined filters ./scripts/outlook-mail.sh query --after 2024-06-01 --folder "Sent Items" --count 100 Query options: --after DATE โ Emails received after date (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS) --before DATE โ Emails received before date --folder NAME โ Search in specific folder --from EMAIL โ Filter by sender email --unread โ Only unread emails --has-attachments โ Only emails with attachments --count N โ Maximum results (default: 20)
./scripts/outlook-mail.sh mark-read <id> # Mark as read ./scripts/outlook-mail.sh mark-unread <id> # Mark as unread ./scripts/outlook-mail.sh flag <id> # Flag as important ./scripts/outlook-mail.sh unflag <id> # Remove flag ./scripts/outlook-mail.sh delete <id> # Move to trash ./scripts/outlook-mail.sh archive <id> # Move to archive ./scripts/outlook-mail.sh move <id> <folder> # Move to folder
./scripts/outlook-mail.sh send <to> <subj> <body> # Send new email ./scripts/outlook-mail.sh reply <id> "body" # Reply to email
./scripts/outlook-mail.sh folders # List mail folders ./scripts/outlook-mail.sh stats # Inbox statistics
./scripts/outlook-calendar.sh events [count] # List upcoming events ./scripts/outlook-calendar.sh today # Today's events ./scripts/outlook-calendar.sh week # This week's events ./scripts/outlook-calendar.sh read <id> # Event details ./scripts/outlook-calendar.sh calendars # List all calendars ./scripts/outlook-calendar.sh free <start> <end> # Check availability
./scripts/outlook-calendar.sh create <subj> <start> <end> [location] # Create event ./scripts/outlook-calendar.sh quick <subject> [time] # Quick 1-hour event
./scripts/outlook-calendar.sh update <id> <field> <value> # Update (subject/location/start/end) ./scripts/outlook-calendar.sh delete <id> # Delete event Date format: YYYY-MM-DDTHH:MM (e.g., 2026-01-26T10:00)
$ ./scripts/outlook-mail.sh inbox 3 { "n": 1, "subject": "Your weekly digest", "from": "digest@example.com", "date": "2026-01-25T15:44", "read": false, "id": "icYY6QAIUE26PgAAAA==" } { "n": 2, "subject": "Meeting reminder", "from": "calendar@outlook.com", "date": "2026-01-25T14:06", "read": true, "id": "icYY6QAIUE26PQAAAA==" } $ ./scripts/outlook-mail.sh read "icYY6QAIUE26PgAAAA==" { "subject": "Your weekly digest", "from": { "name": "Digest", "address": "digest@example.com" }, "to": ["you@hotmail.com"], "date": "2026-01-25T15:44:00Z", "body": "Here's what happened this week..." } $ ./scripts/outlook-mail.sh stats { "folder": "Inbox", "total": 14098, "unread": 2955 } $ ./scripts/outlook-calendar.sh today { "n": 1, "subject": "Team standup", "start": "2026-01-25T10:00", "end": "2026-01-25T10:30", "location": "Teams", "id": "AAMkAGQ5NzE4YjQ3..." } $ ./scripts/outlook-calendar.sh create "Lunch with client" "2026-01-26T13:00" "2026-01-26T14:00" "Restaurant" { "status": "event created", "subject": "Lunch with client", "start": "2026-01-26T13:00", "end": "2026-01-26T14:00", "id": "AAMkAGQ5NzE4YjQ3..." }
Access tokens expire after ~1 hour. Refresh with: ./scripts/outlook-token.sh refresh
~/.outlook-mcp/config.json - Client ID and secret ~/.outlook-mcp/credentials.json - OAuth tokens (access + refresh)
Mail.ReadWrite - Read and modify emails Mail.Send - Send emails Calendars.ReadWrite - Read and modify calendar events offline_access - Refresh tokens (stay logged in) User.Read - Basic profile info
Email IDs: The id field shows the last 20 characters of the full message ID. Use this ID with commands like read, mark-read, delete, etc. Numbered results: Emails are numbered (n: 1, 2, 3...) for easy reference in conversation. Text extraction: HTML email bodies are automatically converted to plain text. Token expiry: Access tokens expire after ~1 hour. Run outlook-token.sh refresh when you see auth errors. Recent emails: Commands like read, mark-read, etc. search the 100 most recent emails for the ID.
"Token expired" โ Run outlook-token.sh refresh "Invalid grant" โ Token invalid, re-run setup: outlook-setup.sh "Insufficient privileges" โ Check app permissions in Azure Portal โ API Permissions "Message not found" โ The email may be older than 100 messages. Use search to find it first. "Folder not found" โ Use exact folder name. Run folders to see available folders.
Personal Microsoft accounts (outlook.com, hotmail.com, live.com) Work/School accounts (Microsoft 365) - may require admin consent
Azure App Registration: The automated setup creates an App Registration in your Azure tenant with the following permissions: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, offline_access, User.Read Local credential storage: Client ID, client secret, and OAuth tokens are stored in ~/.outlook-mcp/ with chmod 600 Token printing: outlook-token.sh get --confirm prints access tokens (requires explicit confirmation flag) Prerequisites: Requires Azure CLI (az) and jq If you prefer not to use automated setup, follow the manual configuration in references/setup.md.
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.