outlook-suite

What this skill does

# Outlook Suite

Automates Microsoft Outlook operations across email, calendar, contacts, tasks, and notes using PowerShell COM objects. 62 scripts organized into 5 focused modules.

## Prerequisites

- Microsoft Outlook installed on Windows (scripts can start Outlook if needed)
- PowerShell 5.1+ (included in Windows 10/11)
- Exchange Server or Microsoft 365 for some features (shared mailboxes, free/busy, rooms, task assignment)

## Safety Rules

1. **Never auto-send** — all send operations require `-Confirm` parameter
2. **Never delete without confirmation** — always confirm with the user before running delete scripts
3. **Draft-first for compose** — create as draft, show the user, then send only after approval
4. **Verify targets** — when acting on a specific item, confirm the subject/recipient with the user before modifying
5. **Prefer EntryID** — always use EntryID over Index when targeting items (Index numbers shift as new items arrive)

## Item Targeting Pattern

All modules use **EntryID** as the primary method to target specific items. EntryID is a permanent, unique identifier that never changes.

**Workflow:**
1. Run a listing or search script to discover items (many return EntryID directly; for mail, prefer `outlook-find.ps1` for stable EntryIDs)
2. Use the EntryID from the results to target a specific item in action scripts

```powershell
# Step 1: Find the item
powershell -File outlook-find.ps1 -From "[email protected]" -Days 3

# Step 2: Act on it using EntryID from results
powershell -File outlook-read-body.ps1 -EntryID "00000000..."
```

Action scripts also accept `-Index` as a fallback, but EntryID is strongly preferred for accuracy.

## Modules

This suite is organized into 5 self-contained modules. Each module has its own detailed documentation with full parameter tables, examples, and reference data. **Load the relevant module documentation based on what the user needs.**

### Email — [outlook-mail/SKILL.md](../outlook-mail/SKILL.md)

The largest module (35 scripts). Handles all email operations:

- **Find and target** — `outlook-find.ps1` for EntryID discovery with rich filtering
- **Read and search** — read inbox, read full body, search, advanced search
- **Compose and send** — draft, update draft, send, send-as, reply, forward, voting buttons
- **Organize** — move, delete, mark read/unread, conversation view, print
- **Flags and metadata** — flag, unflag, importance, sensitivity, save-as
- **Categories** — list, create, assign, remove, delete categories
- **Scheduling** — schedule send, request receipts, recall messages
- **Account management** — folders, accounts, rules, out-of-office, attachment save

### Calendar — [outlook-calendar/SKILL.md](../outlook-calendar/SKILL.md)

10 scripts for calendar and meeting management:

- **Events** — list, create, update, delete appointments
- **Meetings** — respond to invites, manage attendees, forward meetings
- **Recurring events** — create with daily/weekly/monthly/yearly patterns
- **Availability** — check free/busy status, find available rooms

### Contacts — [outlook-contacts/SKILL.md](../outlook-contacts/SKILL.md)

7 scripts for contact management:

- **Browse and search** — list contacts, search by name/email/company
- **Manage** — create, update, delete contacts
- **Extras** — add/remove contact photos, export as vCard

### Tasks — [outlook-tasks/SKILL.md](../outlook-tasks/SKILL.md)

6 scripts for task management:

- **Browse** — list tasks with status/priority filtering
- **Manage** — create, update, complete, delete tasks
- **Delegate** — assign tasks to others (requires Exchange)

### Notes — [outlook-notes/SKILL.md](../outlook-notes/SKILL.md)

4 scripts for Outlook sticky notes:

- **Browse** — list notes with color and date filtering
- **Manage** — create, read full content, delete notes

## Script Quick Reference

> **IMPORTANT FOR AI AGENTS:** This index gives you the correct script name for each operation. Before running any script, you **MUST** read the relevant module SKILL.md (linked in each heading) for full parameter documentation, required vs optional parameters, and usage examples. Do NOT guess parameters from the script name alone.

### Email — [outlook-mail/SKILL.md](../outlook-mail/SKILL.md)

**Find and Target**
- `outlook-find.ps1` — Find emails by criteria, return stable EntryIDs for action scripts

**Read and Search**
- `outlook-read.ps1` — List recent inbox emails with sender, date, unread status, and EntryID
- `outlook-read-body.ps1` — Read full email body by EntryID or index
- `outlook-search.ps1` — Search emails by subject, sender, or body text
- `outlook-search-advanced.ps1` — Multi-filter advanced search (attachments, importance, flags, dates, folders)

**Compose and Send**
- `outlook-draft.ps1` — Create draft email (plain text or HTML, with attachments)
- `outlook-draft-update.ps1` — Modify existing draft (recipients, subject, body, attachments)
- `outlook-send.ps1` — Send email directly (requires -Confirm)
- `outlook-send-as.ps1` — Send from a specific account (requires -Confirm)
- `outlook-reply.ps1` — Reply or Reply All to email (requires -Confirm to send)
- `outlook-forward.ps1` — Forward email to recipients (requires -Confirm to send)
- `outlook-voting.ps1` — Send email with voting buttons/poll (requires -Confirm)

**Organize**
- `outlook-move.ps1` — Move email to a folder by name or path
- `outlook-delete.ps1` — Delete email, soft or permanent (requires -Confirm)
- `outlook-mark-read.ps1` — Mark email as read or unread
- `outlook-conversation.ps1` — View full email conversation thread
- `outlook-print.ps1` — Print email to default printer

**Flags, Importance and Sensitivity**
- `outlook-flag.ps1` — Flag email for follow-up with optional due date and reminder
- `outlook-unflag.ps1` — Remove flag or mark flag as complete
- `outlook-set-importance.ps1` — Set email priority (Low, Normal, High)
- `outlook-set-sensitivity.ps1` — Set email sensitivity (Normal, Personal, Private, Confidential)
- `outlook-save-as.ps1` — Export email to file (msg, txt, html, mht)

**Categories**
- `outlook-list-categories.ps1` — List all categories with colors
- `outlook-create-category.ps1` — Create new category with color
- `outlook-assign-category.ps1` — Assign category to email (appends, does not replace)
- `outlook-remove-category.ps1` — Remove specific or all categories from email
- `outlook-delete-category.ps1` — Delete category from master list

**Scheduling and Receipts**
- `outlook-schedule-send.ps1` — Schedule email to send at a future date/time
- `outlook-request-receipt.ps1` — Send with read and/or delivery receipt requests
- `outlook-recall.ps1` — Attempt to recall a sent email (Exchange only)

**Account and Rule Management**
- `outlook-folders.ps1` — List all mail folders with item and unread counts
- `outlook-accounts-list.ps1` — List all configured email accounts
- `outlook-rules-list.ps1` — List email rules with ON/OFF status
- `outlook-rules-create.ps1` — Create new email rule with conditions and actions
- `outlook-out-of-office.ps1` — Configure Out of Office auto-replies (Exchange)
- `outlook-attachment-save.ps1` — Save email attachments to disk (skips inline images by default)

### Calendar — [outlook-calendar/SKILL.md](../outlook-calendar/SKILL.md)

**Events and Appointments**
- `outlook-calendar-list.ps1` — List upcoming calendar events with EntryIDs
- `outlook-calendar-create.ps1` — Create appointment or meeting with attendees
- `outlook-calendar-update.ps1` — Update an existing event's details (subject, time, location)
- `outlook-calendar-delete.ps1` — Delete a calendar event or meeting

**Meetings and Responses**
- `outlook-calendar-respond.ps1` — Accept, tentatively accept, or decline a meeting invitation
- `outlook-calendar-attendees.ps1` — View attendee list with response status
- `outlook-calendar-forward.ps1` — Forward event as iCalendar (.ics) attachment

**Recurring Events**
- `outlook-calendar-recurring.ps1` — Create recurring event (dai