Agent skill

Outlook

by CraftOS-dev in CraftOS-dev/CraftBot

Read, search, and manage Outlook emails and calendar via Microsoft Graph API.

MITAuto-check passedProductivity & Automation

Install Outlook

skills CLI
$ npx skills add CraftOS-dev/CraftBot --skill outlook -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install CraftOS-dev/CraftBot outlook --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/outlook .claude/skills/outlook && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
outlook
GitHub stars
392
Used in
2 other repos
Token cost
~1.8k tokens
SKILL.md length
412 words
Files
7 (incl. scripts, references)
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Read, search, and manage Outlook emails and calendar via Microsoft Graph API.

  • Works in 5 steps: Log you into Azure (device code flow) → Create an App Registration automatically → Configure API permissions… → …
  • The user asks about emails
  • SKILL.md covers Quick Setup (Automated), Manual Setup, Usage and Calendar, plus 7 more sections
  • Runs Shell scripts from its folder

What it does

Outlook is an agent skill from CraftOS-dev/CraftBot. Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Use when the user asks about emails, inbox, Outlook, Microsoft mail, calendar events, or scheduling.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `_meta.json`, `references/setup.md` and `scripts/outlook-calendar.sh`).

It sits in Productivity & Automation, covering Email management. It works with Microsoft 365, Model Context Protocol and Microsoft Azure. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

  • The user asks about emails
  • Calendar events

Example prompts

  • “/outlook”

Requirements

  • A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Log you into Azure (device code flow)
  2. Create an App Registration automatically
  3. Configure API permissions (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite)
  4. Guide you through authorization
  5. Save credentials to ~/.outlook-mcp/

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 4 files in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Outlook loads about 1.8k tokens when it runs, and up to ~2.9k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 412 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 412 words, ~1,791 tokens.

Download SKILL.mdSave it as .claude/skills/outlook/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
outlook
description
Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Use when the user asks about emails, inbox, Outlook, Microsoft mail, calendar events, or scheduling.
version
1.3.0
author
jotamed

Outlook Skill

Access Outlook/Hotmail email and calendar via Microsoft Graph API using OAuth2.

Quick Setup (Automated)

bash
# Requires: Azure CLI, jq
./scripts/outlook-setup.sh

The setup script will:

  1. Log you into Azure (device code flow)
  2. Create an App Registration automatically
  3. Configure API permissions (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite)
  4. Guide you through authorization
  5. Save credentials to ~/.outlook-mcp/

Manual Setup

See references/setup.md for step-by-step manual configuration via Azure Portal.

Usage

Token Management
bash
./scripts/outlook-token.sh refresh  # Refresh expired token
./scripts/outlook-token.sh test     # Test connection
./scripts/outlook-token.sh get      # Print access token
Reading Emails
bash
./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
./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
Managing Emails
bash
./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
Sending Emails
bash
./scripts/outlook-mail.sh send <to> <subj> <body> # Send new email
./scripts/outlook-mail.sh reply <id> "body"       # Reply to email
Folders & Stats
bash
./scripts/outlook-mail.sh folders                 # List mail folders
./scripts/outlook-mail.sh stats                   # Inbox statistics

Calendar

Viewing Events
bash
./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
Creating Events
bash
./scripts/outlook-calendar.sh create <subj> <start> <end> [location]  # Create event
./scripts/outlook-calendar.sh quick <subject> [time]                  # Quick 1-hour event
Managing Events
bash
./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)

Example Output
bash
$ ./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..."
}

Token Refresh

Access tokens expire after ~1 hour. Refresh with:

bash
./scripts/outlook-token.sh refresh

Files

  • ~/.outlook-mcp/config.json - Client ID and secret
  • ~/.outlook-mcp/credentials.json - OAuth tokens (access + refresh)

Permissions

  • 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

Notes

  • 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.

Troubleshooting

"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.

Show full SKILL.md (143 more words)Show less

Supported Accounts

  • Personal Microsoft accounts (outlook.com, hotmail.com, live.com)
  • Work/School accounts (Microsoft 365) - may require admin consent

Changelog

v1.3.0
  • Added: Calendar support (outlook-calendar.sh)
    • View events (today, week, upcoming)
    • Create/quick-create events
    • Update event details (subject, location, time)
    • Delete events
    • Check availability (free/busy)
    • List calendars
  • Added: Calendars.ReadWrite permission
v1.2.0
  • Added: mark-unread - Mark emails as unread
  • Added: flag/unflag - Flag/unflag emails as important
  • Added: delete - Move emails to trash
  • Added: archive - Archive emails
  • Added: move - Move emails to any folder
  • Added: from - Filter emails by sender
  • Added: attachments - List email attachments
  • Added: reply - Reply to emails
  • Improved: send - Better error handling and status output
  • Improved: move - Case-insensitive folder names, shows available folders on error
v1.1.0
  • Fixed: Email IDs now use unique suffixes (last 20 chars)
  • Added: Numbered results (n: 1, 2, 3...)
  • Improved: HTML bodies converted to plain text
  • Added: to field in read output
v1.0.0
  • Initial release

© CraftOS-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (scripts, references) in skills/outlook of CraftOS-dev/CraftBot.

  • SKILL.md
  • _meta.json
  • references/setup.md
  • scripts/outlook-calendar.sh
  • scripts/outlook-mail.sh
  • scripts/outlook-setup.sh
  • scripts/outlook-token.sh

Open the folder on GitHubat commit b50970c

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in CraftOS-dev/CraftBot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Outlook next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Outlook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Outlook this skillCraftOS-dev/CraftBot3922 repos~1.8kAutomated safety check: PassMIT
Microsoft DocsMicrosoftDocs/mcp1.9k1 repos~723Automated safety check: PassCC-BY-4.0
Entra Agent Idmicrosoft/GitHub-Copilot-for-Azure2553 repos~4kAutomated safety check: PassMIT
Outlook EmailPorabuild/Poracode114—~574Automated safety check: PassApache-2.0
E2atokencanopy/e2a192—~4.7kAutomated safety check: PassApache-2.0
SupercompressSupercompress/Supercompress106—~519Automated safety check: PassMIT

Similar skills

  • Microsoft Docs

    MicrosoftDocs/mcp

    Official

    Understand Microsoft technologies by querying official documentation.

    1.9k GitHub starsUsed in 1 repo~723 tokens
    Agent WorkflowsAuto-check passed
  • Entra Agent Id

    microsoft/GitHub-Copilot-for-Azure

    Official

    Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant)…

    255 GitHub starsUsed in 3 repos~4k tokens
    Backend & APIsAuto-check passed
  • Outlook Email

    Porabuild/Poracode

    Triage an Outlook inbox, summarize threads, and draft replies through the Microsoft 365 MCP server.

    114 GitHub stars~574 tokensUpdated today
    Documents & OfficeAuto-check passed
  • E2a

    tokencanopy/e2a

    A skill your agent uses when operating an already-connected e2a inbox over MCP: reading, composing, sending, replying, forwarding, handling attachments, managing contacts/outreach, scheduling mail…

    192 GitHub stars~4.7k tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • Supercompress

    Supercompress/Supercompress

    Always-on context compression for Grok Build. An agent skill from Supercompress/Supercompress.

    106 GitHub stars~519 tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Gmail Query Syntax

    provos/ironcurtain

    Reference for Gmail's search query syntax — operators like is:sent, newerthan:, from:, has:attachment, label:, and how they compose.

    613 GitHub stars~971 tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

More from CraftOS-dev/CraftBot

All 89 skills in this repo
  • Self Improvement

    CraftOS-dev/CraftBot

    Captures learnings, errors, and corrections to enable continuous improvement.

    392 GitHub starsUsed in 5 repos~4.9k tokens
    Auto-check passed
  • Bbc News

    CraftOS-dev/CraftBot

    Fetch and display BBC News stories from various sections and regions via RSS feeds.

    392 GitHub starsUsed in 2 repos~555 tokens
    Auto-check passed
  • Nano Banana Pro

    CraftOS-dev/CraftBot

    Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image).

    392 GitHub starsUsed in 6 repos~1.4k tokens
    Auto-check passed
  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Telegram Bot Manager

    CraftOS-dev/CraftBot

    Manage and configure Telegram bots for OpenClaw. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~836 tokensUpdated today
    Auto-check passed
  • Baidu Search

    CraftOS-dev/CraftBot

    Search the web using Baidu AI Search Engine (BDSE). An agent skill from CraftOS-dev/CraftBot.

    392 GitHub starsUsed in 1 repo~518 tokens
    Auto-check passed

Questions about Outlook

What does Outlook do?

Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Outlook is an agent skill from CraftOS-dev/CraftBot. Read, search, and manage Outlook emails and calendar via Microsoft Graph API.

When should I use Outlook?

Outlook fits situations like: the user asks about emails; calendar events.

How do I install Outlook in Claude Code?

Run `npx skills add CraftOS-dev/CraftBot --skill outlook -a claude-code`. Or copy the skill folder (skills/outlook in CraftOS-dev/CraftBot) into .claude/skills/outlook in your project. Claude Code loads it when a task matches its description.

How do I install Outlook in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill outlook -a codex`. Or copy the skill folder (skills/outlook in CraftOS-dev/CraftBot) into .agents/skills/outlook in your project. Codex loads it when a task matches its description.

Can I use Outlook in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CraftOS-dev/CraftBot --skill outlook -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/outlook, .gemini/skills/outlook, .github/skills/outlook and .opencode/skills/outlook in your project.

What does Outlook need to run?

Going by SKILL.md and its folder, Outlook needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Outlook access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Outlook safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Outlook use?

Outlook is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Outlook use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to Outlook?

Skills that share tags, products or a category with Outlook: Microsoft Docs (MicrosoftDocs/mcp, 1.9k stars), Entra Agent Id (microsoft/GitHub-Copilot-for-Azure, 255 stars), Outlook Email (Porabuild/Poracode, 114 stars) and E2a (tokencanopy/e2a, 192 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Outlook?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

Source: CraftOS-dev/CraftBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.