outlook

name	outlook
description	Outlook integration — read/send emails, manage calendar and contacts via PowerShell (Windows) or osascript (Mac).
user-invocable	false

Access

No MCP server — you use Bash directly with PowerShell (Windows) or osascript (macOS).

Detect Platform

if [[ "$(uname)" == "Darwin" ]]; then echo "mac"; else echo "win"; fi

Windows — Companion Scripts

Ready-to-use PowerShell scripts are in scripts/. All output JSON.

Script	Purpose	Example Call
read-emails.ps1	Last N emails	powershell -NoProfile -File scripts/read-emails.ps1 -Count 5
get-email.ps1	Single email by ID	powershell -NoProfile -File scripts/get-email.ps1 -EntryID "..."
search-emails.ps1	Search emails	powershell -NoProfile -File scripts/search-emails.ps1 -Query "invoice"
send-email.ps1	Send email	powershell -NoProfile -File scripts/send-email.ps1 -To "[e-mail]" -Subject "Hi" -Body "Text"
read-calendar.ps1	Events in date range	powershell -NoProfile -File scripts/read-calendar.ps1 -Days 14
create-event.ps1	Create event	powershell -NoProfile -File scripts/create-event.ps1 -Subject "Meeting" -Start "2025-03-01 14:00"
search-contacts.ps1	Search contacts	powershell -NoProfile -File scripts/search-contacts.ps1 -Query "Smith"

Important: Run scripts from the skill directory (cd there or use absolute path).

Optional Parameters

• send-email.ps1: -CC "[e-mail]"
• create-event.ps1: -Duration 60 (min, default 60), -Location "...", -Body "..."
• read-emails.ps1: -Count N (default 10)
• read-calendar.ps1: -Days N (default 7)
• search-emails.ps1: -Count N (default 20)

macOS

On macOS, the macos-pim skill handles Mail, Calendar and Contacts via osascript (Apple Mail, Calendar.app, Contacts.app). This skill is Windows-only.

Guidelines

• Reading emails: First get overview (Subject, From, Date), then get-email.ps1 for details
• Sending emails: ALWAYS confirm recipient and subject with user before sending
• No bulk operations: Max 50 emails/events per query
• HTML body: Summarize as plain text for the user
• Outlook contacts != WhatsApp contacts in memory/people/
• Error handling: If Outlook is not running or not installed, inform the user
• Output: All scripts output JSON — directly parsable