microsoft-graph-skill/SKILL.md

name	description
microsoft-graph	Microsoft Graph API access for Mikkel's Outlook and OneDrive (mikpar@outlook.dk). Use for email, calendar, and file operations via Graph API. Triggers on Outlook, OneDrive, or Microsoft 365 tasks.

Microsoft Graph Skill

Microsoft Graph API client for Mikkel's personal Microsoft account (mikpar@outlook.dk).

Quick Start

# Authenticate (first time / token expired)
python3 scripts/graph_client.py auth

# List recent emails
python3 scripts/graph_client.py mail list --limit 10

# Read specific email
python3 scripts/graph_client.py mail read --id <message_id>

# Send email
python3 scripts/graph_client.py mail send --to "to@example.com" --subject "Test" --body "Hello"

# List OneDrive root
python3 scripts/graph_client.py drive list

# List folder contents
python3 scripts/graph_client.py drive list --path "Documents/Parlobyg"

# Download file
python3 scripts/graph_client.py drive download --path "file.pdf" --output ./file.pdf

Credentials

• Account: mikpar@outlook.dk
• Client ID: 96861287-203e-4d84-ad3b-379d63ba5eb2
• Tenant ID: 3a22994f-512f-447e-b8fa-19bbc849bd0c
• Client Secret: kiB8Q~TmhWDKHRdLqBi_RqRIIAjTkljyL6xE0aHU

Authentication

Uses device code flow for personal Microsoft accounts:

1. Run python3 scripts/graph_client.py auth
2. Open the URL shown (https://microsoft.com/devicelogin)
3. Enter the code displayed
4. Sign in with mikpar@outlook.dk
5. Token is saved to ~/.config/microsoft-graph/token.json

Token auto-refreshes. Re-auth only needed if refresh token expires (~90 days).

Capabilities

Outlook Email

• 📧 List/search inbox
• 📖 Read messages
• ✉️ Send emails
• 📝 Create drafts
• 📁 Manage folders

OneDrive

• 📂 Browse folders
• 🔍 Search files
• ⬇️ Download files
• ⬆️ Upload files
• 🔗 Create sharing links

Calendar (if needed)

• 📅 List events
• ➕ Create events
• 🔔 Check availability

API Reference

• Base URL: https://graph.microsoft.com/v1.0
• Scopes: Mail.Read Mail.Send Files.ReadWrite User.Read offline_access

References

• Graph API Docs