skills.rest
muhammaddadu
muhammaddaduCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

outlook

Read, search, draft, and send Outlook mail and manage Microsoft 365 calendar events via CLI.

1|1|Updated Jul 6, 2026
Search Tags:#cli#email#calendar#outlook#microsoft 365#draft reply#free busy
One-click install
npx skills add https://github.com/muhammaddadu/ai-skill-collection --skill outlook-muhammaddadu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: outlook
Source: https://github.com/muhammaddadu/ai-skill-collection/tree/main/utilities/outlook
Command: npx skills add https://github.com/muhammaddadu/ai-skill-collection --skill outlook-muhammaddadu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Outlook inbox and calendar by hand is repetitive: triaging unread mail, finding old threads, drafting replies, checking availability, and scheduling meetings all require manual clicks. This Skill lets an AI agent perform those tasks through the outlook CLI, which wraps the Outlook REST API using the user's existing Outlook Web session. ## Core Features & Use Cases - Mail triage and search: List, filter, and full-text search messages with flags like --unread, --from, --since, and --has-attachments, then read full message bodies on demand. - Review-first drafting: Create drafts, draft replies, reply-alls, and forwards with attachments so the user reviews in Outlook before anything is sent; direct send is reserved for explicitly confirmed messages. - Calendar management: View agendas with expanded recurring events, create or update events, RSVP to invitations, and run free/busy lookups to suggest meeting times. - Adaptive behavior: A built-in learnings system records durable user preferences (sign-off style, recipient aliases, tone) so future drafts match how the user actually writes. - Use Case: Ask "anything unread from my boss this week?" and the agent runs outlook unread --from boss@example.com --since 7d, summarizes the results, then drafts a reply in the user's voice for review. ## Quick Start Ask the agent to check your Outlook inbox and summarize your unread messages from today.

Frequently Asked Questions about outlook

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search my Outlook inbox from the command line?▼

Use `outlook search "<query>"` for KQL full-text search, combined with filters like `--from`, `--since 7d`, or `--has-attachments`. For sender filtering, the `--from` flag is faster and more reliable than embedding `from:` in the query string.

How do I draft an email reply with an AI agent in Outlook?▼

Find the message ID with `outlook search` or `outlook list`, then run `outlook draft-reply <id>` with a JSON body containing your reply text. The draft lands in your Drafts folder with the original thread quoted, ready for review before sending.

Does the outlook CLI work with Gmail or IMAP accounts?▼

No, the outlook CLI is specific to Outlook and Microsoft 365, wrapping the Outlook REST API via the user's Outlook Web session. It does not support Gmail, IMAP, or other non-Microsoft mail providers.

Why does the outlook CLI return exit code 2?▼

Exit code 2 means the authentication session expired or is blocked (E_AUTH_REQUIRED). The user must run `outlook auth` manually because it opens a browser window requiring interactive MFA sign-in; the agent cannot re-authenticate on its own.

Can I attach files to Outlook drafts from the command line?▼

Yes, pass `--attach <path>` (repeatable) to `draft`, `draft-reply`, `draft-reply-all`, `draft-forward`, or `send`. Files are base64-encoded as Outlook FileAttachment resources with a roughly 3 MB per-file limit; larger files require OneDrive.

When should I use draft instead of send for Outlook mail?▼

Always prefer `draft` or `draft-reply` so the user can review in Outlook before sending. Only use `send` when the user has explicitly confirmed the recipient, subject, and body in plain English, since sending skips all review.

Related Skills

Explore More Personal & Entrepreneur Skills→
naftikonaftiko

Get Focused Inbox Override

Retrieve a Focused Inbox classification override by ID from the Microsoft Outlook Mail API.

Official
Basic
KhaledMKhaledKhaledMKhaled

ai-secretary

Draft emails, manage schedules, and organize tasks and meeting agendas.

Community
Advanced
cellarwoodcellarwood

recipe-find-free-time

Query Google Calendar free/busy data across multiple calendars to find common open slots.

Official
Intermediate
tamirdreshertamirdresher
41

Mail MCP Server - Research & Recommendation

Automate Microsoft 365 email operations via the Microsoft Graph API.

Community
Intermediate