officeclaw
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 Outlook mail, manage calendar appointments, or handle Microsoft To Do tasks.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/danielithomas/officeclawOfficeClaw: Microsoft Graph API Integration
Connect your OpenClaw agent to personal Microsoft accounts (Outlook.com, Hotmail, Live) to manage email, calendar, and tasks through the Microsoft Graph API.
Installation
Install from PyPI:
pip install officeclaw
Or with uv:
uv pip install officeclaw
Verify installation:
officeclaw --version
Setup (One-Time)
Quick start: OfficeClaw ships with a default app registration — just run
officeclaw auth loginand go. No Azure setup needed.Advanced: Want full control? Create your own Azure App Registration (free, ~5 minutes) and set
OFFICECLAW_CLIENT_IDin your.env. See Microsoft's guide or follow the steps below.
1. Create an Azure App Registration
- 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.SendCalendars.Read,Calendars.ReadWriteTasks.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, andCalendars.ReadWrite. OfficeClaw will gracefully error on commands that require missing permissions.
2. Configure Environment
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.
3. Authenticate
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).
When to Use This Skill
Activate this skill when the user needs to:
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-danielithomas-officeclaw": {
"enabled": true,
"auto_update": true
}
}
}