Introduction
# Microsoft 365 Integration
## Description Access Microsoft 365 services - Email (Outlook), Calendar, OneDrive, To Do tasks, and Contacts via MS Graph API.
## Activation Activated when user mentions: outlook, email, calendar, onedrive, microsoft, office 365, o365, ms365, my meetings, my emails, schedule meeting, send email, check calendar, to do, microsoft tasks
## Configuration Authentication is cached after first login. No environment variables required for device code flow.
For headless/automated operation, set these environment variables: - MS365_MCP_CLIENT_ID - Azure AD app client ID - MS365_MCP_CLIENT_SECRET - Azure AD app secret - MS365_MCP_TENANT_ID - Tenant ID (use "consumers" for personal accounts)
## Available Commands
### Authentication
```bash # Login via device code (interactive) python3 /root/clawd/skills/ms365/ms365_cli.py login
# Check authentication status python3 /root/clawd/skills/ms365/ms365_cli.py status
# List cached accounts python3 /root/clawd/skills/ms365/ms365_cli.py accounts
# Get current user info python3 /root/clawd/skills/ms365/ms365_cli.py user ```
### Email (Outlook)
```bash # List recent emails python3 /root/clawd/skills/ms365/ms365_cli.py mail list [--top N]
# Read specific email python3 /root/clawd/skills/ms365/ms365_cli.py mail read MESSAGE_ID
# Send email python3 /root/clawd/skills/ms365/ms365_cli.py mail send --to "[email protected]" --subject "Subject" --body "Message body" ```
### Calendar
```bash # List upcoming events python3 /root/clawd/skills/ms365/ms365_cli.py calendar list [--top N]
# Create event python3 /root/clawd/skills/ms365/ms365_cli.py calendar create --subject "Meeting" --start "2026-01-15T10:00:00" --end "2026-01-15T11:00:00" [--body "Description"] [--timezone "America/Chicago"] ```
### OneDrive Files
```bash # List files in root python3 /root/clawd/skills/ms365/ms365_cli.py files list
# List files in folder python3 /root/clawd/skills/ms365/ms365_cli.py files list --path "Documents" ```
### To Do Tasks
```bash # List task lists python3 /root/clawd/skills/ms365/ms365_cli.py tasks lists
# Get tasks from a list python3 /root/clawd/skills/ms365/ms365_cli.py tasks get LIST_ID
# Create task python3 /root/clawd/skills/ms365/ms365_cli.py tasks create LIST_ID --title "Task title" [--due "2026-01-20"] ```
### Contacts
```bash # List contacts python3 /root/clawd/skills/ms365/ms365_cli.py contacts list [--top N]
# Search contacts python3 /root/clawd/skills/ms365/ms365_cli.py contacts search "John" ```
## Usage Examples
User: "Check my outlook email" Agent: Runs `mail list --top 10` command
User: "What meetings do I have today?" Agent: Runs `calendar list` command
User: "Send an email to [email protected] about the project update" Agent: Runs `mail send` with appropriate parameters
User: "Show my OneDrive files" Agent: Runs `files list` command
User: "Add a task to review the budget" Agent: Lists task lists first, then creates task in appropriate list
## Prompts
When helping with Microsoft 365: - Use the ms365_cli.py script for all operations - Check authentication status first if commands fail - If not logged in, guide user through device code login - For calendar events, use ISO 8601 datetime format - Default timezone is America/Chicago - When sending email, confirm recipient and content before sending - For tasks, list available task lists first so user can choose
## Attribution
This skill uses the **ms-365-mcp-server** by Softeria. - **NPM Package**: [@softeria/ms-365-mcp-server](https://www.npmjs.com/package/@softeria/ms-365-mcp-server) - **GitHub**: https://github.com/Softeria/ms-365-mcp-server - **License**: MIT