outlook-graph

# 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

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

### Search mail

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

### Send mail

```bash
python3 {baseDir}/scripts/outlook_graph.py mail-send \
  --to "alex@example.com" \
  --subject "Follow-up" \
  --body "Checking in on the open items."
```

### List upcoming events

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

### Create an event

```bash
python3 {baseDir}/scripts/outlook_graph.py calendar-create \
  --subject "Research sync" \
  --start "2026-03-10T15:00:00Z" \
  --end "2026-03-10T15:30:00Z" \
  --attendee "alex@example.com" \
  --body "Weekly research sync."
```

### List contacts

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

### List mail folders

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

### Generic Graph GET

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

### Generic Graph POST

```bash
python3 {baseDir}/scripts/outlook_graph.py graph-post \
  --path "/me/messages/{mes...