MS Outlook + Teams Assistant (Desktop-first)

What this skill does

Inbox nagging (Outlook Desktop): find messages from the last 7 days that likely need a reply, then send reminders until dismissed.
Email reply drafting: produce concise drafts that match the user’s tone rules (conversational, spartan, polite; simple English; short; reduce redundancy; avoid em dashes).
Teams tracking (optional): if Microsoft Graph is configured and permitted by tenant policy, track recent Teams chat messages that likely need a reply and nag similarly.

Safety defaults

Do not auto-send emails or Teams messages.
Create drafts in Outlook, or paste drafts into Telegram for approval.
For reminders: send to Telegram by default; only send to Teams if explicitly enabled.

Setup (one time)

A) Outlook Desktop automation (recommended)

Ensure Outlook Desktop is installed and signed in.
Install the Python dependency (ask before doing this on the machine):
- ```
pip install pywin32
```
Create a config file:
- Copy
```
references/config.example.json
```
  →
```
references/config.json
```
  and fill it.
- IMPORTANT: Do not commit
```
references/config.json
```
  if it contains personal IDs.

B) Teams via Graph (optional)

Only if you can create an Entra ID app registration and grant permissions.

Copy

references/config.example.json

→

references/config.json

and fill

teams.tenantId

teams.clientId

, and

teams.scopes

Then run
```
scripts/teams_scan.py
```
once to complete Device Code sign-in.

See

references/teams-graph-setup.md

Core workflows

1) Scan and remind (Outlook)

Use

scripts/scan_outlook.py

1b) Scan Teams (Graph)

Use

scripts/teams_scan.py

Parameters:

```
--days 7
```
(default)

First run will print a device code sign-in message (follow it once).

Parameters:

```
--days 7
```
(default)
```
--mode report|telegram
```
(default: report)
```
--max-items 200
```

Heuristics (editable in config):

Within last N days
Not from obvious broadcast sources
Prefer threads where user is To: (not only CC) OR subject/body contains direct asks
Prefer messages not replied by user (best-effort)

Output:

A list of actionable items with: subject, sender, received time, why it was flagged.

Then:

If
```
--mode telegram
```
, send a single concise reminder message with bullet items.

2) Dismiss / snooze an item

This skill uses a local state file to avoid nag loops.

Dismiss: add the message’s
```
internetMessageId
```
(or subject+timestamp fallback) to the dismissed list.
Snooze: store a
```
snoozeUntil
```
timestamp.

Use

scripts/state.py

helpers (or edit JSON directly if needed).

3) Draft an email reply (Outlook)

Use

scripts/draft_reply.py

4) Generate reminders (no send)

Use

scripts/scan_all.py

to update cached scan results, then

scripts/remind.py

to generate a Telegram-ready reminder message (it does not send). It applies:

1:1 Teams → remind when
```
needsReply=true
```
Group Teams → remind when
```
mentionedMe=true
```
AND
```
needsReply=true
```
Outlook → remind for flagged items

The agent should send the output to Telegram if non-empty.

Inputs:

Either a message
```
EntryID
```
(preferred) or search by subject + recent window.

Behavior:

Extract the thread (best-effort) + key metadata.
Generate 2 drafts:
- Short (2–5 sentences)
- Normal (5–10 sentences)
Apply tone rules from
```
references/writing-style.md
```
.

Outputs:

Print drafts to stdout.
Optionally create an Outlook draft reply (no sending) if
```
--create-draft
```
is set.

When you need more context from the user

Ask only what you cannot infer:

Which email to reply to (subject / sender / when)
The user’s intent (agree/decline/ask for info/confirm timeline)
Any constraints (deadlines, attachments, names)

Keep questions minimal (max 3 at a time).

MS Outlook + Teams Assistant

AI Skill Market Insights

Be Part of the 2,407+ Developer Community