Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Connect to personal Microsoft accounts via Microsoft Graph API to manage email, calendar events, and tasks. Use this skill when the user needs to read/write...
Connect to personal Microsoft accounts via Microsoft Graph API to manage email, calendar events, and tasks. Use this skill when the user needs to read/write...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Connect your OpenClaw agent to personal Microsoft accounts (Outlook.com, Hotmail, Live) to manage email, calendar, and tasks through the Microsoft Graph API.
Install from PyPI: pip install officeclaw Or with uv: uv pip install officeclaw Verify installation: officeclaw --version
Quick start: OfficeClaw ships with a default app registration โ just run officeclaw auth login and go. No Azure setup needed. Advanced: Want full control? Create your own Azure App Registration (free, ~5 minutes) and set OFFICECLAW_CLIENT_ID in your .env. See Microsoft's guide or follow the steps below.
Go to entra.microsoft.com โ App registrations โ New registration Name: officeclaw (or anything you like) Supported account types: Personal Microsoft accounts only Redirect URI: leave blank (not needed for device code flow) Click Register Copy the Application (client) ID โ this is your OFFICECLAW_CLIENT_ID Go to Authentication โ Advanced settings โ Allow public client flows โ Yes โ Save Go to API permissions โ Add permission โ Microsoft Graph โ Delegated permissions. Choose based on your needs: Read-only (safest): Mail.Read, Calendars.Read, Tasks.ReadWrite* Full access (all features including send/delete): Mail.Read, Mail.ReadWrite, Mail.Send Calendars.Read, Calendars.ReadWrite Tasks.ReadWrite *Tasks.ReadWrite is the minimum available scope for Microsoft To Do โ there is no read-only option. Least privilege: Only grant the permissions you actually need. If you only want to read emails and calendar, skip Mail.ReadWrite, Mail.Send, and Calendars.ReadWrite. OfficeClaw will gracefully error on commands that require missing permissions.
Create a .env file in your skill directory: OFFICECLAW_CLIENT_ID=your-client-id-here # Capability gates (disabled by default for safety) # OFFICECLAW_ENABLE_SEND=true # Allow sending/replying/forwarding emails # OFFICECLAW_ENABLE_DELETE=true # Allow deleting emails, events, and tasks No client secret needed for device code flow. Write operations (send, delete) are disabled by default โ enable only what you need.
officeclaw auth login This displays a URL and code. Open the URL in a browser, enter the code, and sign in with your Microsoft account. Tokens are stored securely in ~/.officeclaw/token_cache.json (permissions 600).
Activate this skill when the user needs to:
Read emails: "Show me my latest emails", "Find emails from john@example.com" Send emails: "Send an email to...", "Reply to the last email from..." Manage inbox: "Mark emails as read", "Archive old emails", "Delete emails"
View events: "What's on my calendar today?", "Show meetings this week" Create events: "Schedule a meeting with...", "Add dentist appointment on Friday" Update events: "Move the 2pm meeting to 3pm", "Cancel tomorrow's standup"
List tasks: "What's on my to-do list?", "Show incomplete tasks" Create tasks: "Add 'buy groceries' to my tasks", "Create a task to review report" Complete tasks: "Mark 'finish proposal' as done", "Complete all shopping tasks"
officeclaw auth login # Authenticate via device code flow officeclaw auth status # Check authentication status officeclaw auth logout # Clear stored tokens
officeclaw mail list --limit 10 # List recent messages officeclaw mail list --unread # List unread messages only officeclaw mail get <message-id> # Get specific message officeclaw mail send --to user@example.com --subject "Hello" --body "Message text" officeclaw mail send --to user@example.com --subject "Report" --body "Attached" --attachment report.pdf officeclaw mail search --query "from:boss@example.com" officeclaw mail archive <message-id> # Archive a message officeclaw mail mark-read <message-id> # Mark as read officeclaw --json mail list # JSON output for parsing
officeclaw calendar list --start 2026-02-01 --end 2026-02-28 officeclaw calendar create \ --subject "Team Meeting" \ --start "2026-02-15T10:00:00" \ --end "2026-02-15T11:00:00" \ --location "Conference Room" officeclaw calendar get <event-id> officeclaw calendar update <event-id> --subject "Updated Meeting" officeclaw calendar delete <event-id> officeclaw --json calendar list --start 2026-02-01 --end 2026-02-28
officeclaw tasks list-lists # List task lists officeclaw tasks list --list-id <list-id> # List tasks officeclaw tasks list --list-id <list-id> --status active # Active tasks only officeclaw tasks create --list-id <list-id> --title "Complete report" --due-date "2026-02-20" officeclaw tasks complete --list-id <list-id> --task-id <task-id> officeclaw tasks reopen --list-id <list-id> --task-id <task-id>
Use --json flag for structured JSON output: officeclaw --json mail list Returns: { "status": "success", "data": [ { "id": "AAMkADEzN...", "subject": "Meeting Notes", "from": {"emailAddress": {"address": "sender@example.com"}}, "receivedDateTime": "2026-02-12T10:30:00Z", "isRead": false } ] }
Common errors and solutions: ErrorCauseSolutionAuthenticationErrorNot logged in or token expiredRun officeclaw auth loginAccessDeniedMissing permissionsRe-authenticate with required scopesResourceNotFoundInvalid IDVerify the ID existsRateLimitErrorToo many API callsWait 60 seconds and retry
When using this skill: Confirm destructive actions: Ask before deleting or sending Summarize results: Don't show raw JSON, provide summaries Handle errors gracefully: Guide user through re-authentication Respect privacy: Don't log email content Use JSON mode: For programmatic parsing, use --json flag Batch operations: Process multiple items efficiently
Write operations disabled by default: Send, reply, forward, and delete are all blocked unless explicitly enabled via OFFICECLAW_ENABLE_SEND and OFFICECLAW_ENABLE_DELETE environment variables. This prevents accidental or unauthorised write actions. No client secret required: Uses device code flow (public client) by default Least-privilege permissions: You choose which Graph API scopes to grant โ read-only is sufficient for most use cases. See the setup guide above. Tokens stored securely: ~/.officeclaw/token_cache.json with 600 file permissions No data storage: OfficeClaw passes data through, never stores email/calendar content No telemetry: No usage data collected Your own Azure app: Each user creates their own Azure app registration with their own client ID โ no shared credentials
If the skill isn't working: Check authentication: Run officeclaw auth status Re-authenticate: Run officeclaw auth login Verify network: Ensure graph.microsoft.com is reachable Check environment: Verify OFFICECLAW_CLIENT_ID is set in .env
OfficeClaw on GitHub OfficeClaw on PyPI Microsoft Graph API OpenClaw
Workflow acceleration for inboxes, docs, calendars, planning, and execution loops.
Largest current source with strong distribution and engagement signals.