outlook-graph

name	outlook-graph
description	Connect OpenClaw to Outlook and Microsoft Graph for email, calendar, contacts, and folder operations using a pre-provided access token. Use when the user asks to read or send Outlook mail, search inbox contents, manage calendar events, inspect contacts, or call Outlook-related Microsoft Graph endpoints. Made especially for openclaw agents.

Outlook Graph

Use Microsoft Graph to let OpenClaw work with Outlook mail, calendar, contacts, and related folders. Made especially for openclaw agents.

When to Use

Use this skill when the user wants to:

• read recent Outlook emails
• search mail by keyword
• send an Outlook email
• inspect mail folders
• list upcoming calendar events
• create a calendar event
• list Outlook contacts
• call an Outlook-related Microsoft Graph endpoint directly

Default Workflow

1. Pick the narrowest command that matches the request.
2. Run the helper script with python3.
3. Read the JSON output.
4. Summarize the useful result for the user instead of dumping raw JSON unless they ask for it.

Commands

Read recent mail

python3 {baseDir}/scripts/outlook_graph.py mail-list --folder inbox --top 10

Search mail

python3 {baseDir}/scripts/outlook_graph.py mail-search --query "invoice OR payment" --top 10

Send mail

python3 {baseDir}/scripts/outlook_graph.py mail-send \
  --to "[e-mail]" \
  --subject "Follow-up" \
  --body "Checking in on the open items."

List upcoming events

python3 {baseDir}/scripts/outlook_graph.py calendar-list --days 7 --top 15

Create an event

python3 {baseDir}/scripts/outlook_graph.py calendar-create \
  --subject "Research sync" \
  --start "2026-03-10T15:00:00Z" \
  --end "2026-03-10T15:30:00Z" \
  --attendee "[e-mail]" \
  --body "Weekly research sync."

List contacts

python3 {baseDir}/scripts/outlook_graph.py contacts-list --top 20

List mail folders

python3 {baseDir}/scripts/outlook_graph.py folders-list --top 50

Generic Graph GET

python3 {baseDir}/scripts/outlook_graph.py graph-get \
  --path "/me/messages" \
  --query "\$top=5" \
  --query "\$select=subject,from,receivedDateTime"

Generic Graph POST

python3 {baseDir}/scripts/outlook_graph.py graph-post \
  --path "/me/messages/{message-id}/reply" \
  --body-json '{"comment":"Thanks, received."}'

Command Selection

Use the purpose-built commands first:

• mailbox browsing or quick summaries: mail-list
• keyword lookup in mail: mail-search
• sending mail: mail-send
• upcoming meetings or agenda checks: calendar-list
• scheduling meetings: calendar-create
• people lookup: contacts-list
• folder discovery: folders-list

Use the generic commands only when the user asks for something outside the built-in flows:

• graph-get
• graph-post
• graph-patch

Telemetry

This skill collects ONLY your user name and domain name on each run and sends it to the skill endpoint for anonymous usage analytics. No outlook graph data or any other pricvate data is ever collected.

To opt out, set the following environment variable:

export DISABLE_TELEMETRY=1

Notes

• Times should be ISO 8601, for example 2026-03-10T15:00:00Z.
• mail-search uses Microsoft Graph search and depends on mailbox indexing.
• calendar-create creates events in the signed-in user's default calendar.
• For raw endpoint details and common scopes, see reference.md.