A specialized skill for AI assistants to manage Outlook emails and calendars as an authorized delegate for another user.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install outlook-skill-clawhub
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install outlook-skill-clawhub using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Outlook Delegate?
The Outlook Delegate skill is a robust extension for Openclaw Skills designed for scenarios where an AI assistant requires access to another user's Microsoft 365 resources. Unlike standard integrations that use direct access, this skill implements a delegate architecture. This allows your AI assistant to authenticate with its own account while performing tasks—such as reading, searching, and sending emails—within the owner's mailbox and calendar scope.
Built upon the Microsoft Graph API, this skill is specifically modified to handle shared permissions like Mail.ReadWrite.Shared and Calendars.ReadWrite.Shared. It is the ideal solution for developers building executive assistants or team-wide automation agents that need to act on behalf of specific individuals while maintaining a clear audit trail and secure OAuth2 authentication flow within Openclaw Skills.
Outlook Delegate Use Cases
- AI assistants managing an executive's inbox and filtering high-priority communications.
- Automated scheduling and event creation on a manager's calendar as an authorized delegate.
- Searching and archiving historical emails within a shared or owner's mailbox for research.
- Replying to urgent client inquiries using the send-on-behalf functionality.
How Outlook Delegate Works
- The AI assistant authenticates via OAuth2 using its own dedicated Microsoft 365 credentials.
- The skill identifies the target mailbox using the owner_email specified in the configuration file.
- API requests are routed through the /users/{id} endpoint instead of the standard /me endpoint to target the delegated resource.
- The system validates that the assistant has been granted the necessary Exchange delegate permissions (e.g., Editor or FullAccess).
- Actions are executed, and when sending mail, the skill explicitly sets the from field to maintain the delegate relationship.
Outlook Delegate Setup
To integrate this with your Openclaw Skills setup, follow these steps:
- Register an App in Azure AD with delegated permissions:
Mail.ReadWrite.Shared,Mail.Send.Shared,Calendars.ReadWrite.Shared, andoffline_access. - Create the configuration file at
~/.outlook-mcp/config.json:
{
"client_id": "your-app-client-id",
"client_secret": "your-app-client-secret",
"owner_email": "[email protected]",
"delegate_email": "[email protected]"
}
- Grant delegate permissions via PowerShell or Outlook settings:
Set-Mailbox -Identity "[email protected]" -GrantSendOnBehalfTo "[email protected]"
- Initialize the token flow:
./scripts/outlook-token.sh refresh
./scripts/outlook-token.sh test
Outlook Delegate Data Schema & Taxonomy
The skill manages its state and metadata through local JSON files and structured API responses:
| File | Purpose |
|---|---|
config.json |
Stores Client credentials, Owner ID, and Delegate ID |
credentials.json |
Stores encrypted OAuth2 access and refresh tokens |
Email Metadata Taxonomy:
id: Unique Microsoft Graph message identifiersubject: Email subject linefrom: Sender details (includes on-behalf-of markers)body: Content in Text or HTML format
Calendar Metadata Taxonomy:
start/end: ISO 8601 timestampslocation: Physical or virtual meeting locationshowAs: Availability status (busy, free, tentative)
Outlook Delegate Advanced Features
- Send-on-behalf implementation ensures recipients see the assistant acting for the owner.
- Granular mailbox folder management including move, archive, and deep search capabilities.
- Free/Busy availability checks for optimized calendar scheduling.
- Automated token lifecycle management with built-in refresh scripts.
- Full support for multi-agent environments within Openclaw Skills where different agents may represent different delegates.
SKILL.md
Loading
Related Openclaw Skills
Web Search Skill
A zero-config CLI tool that retrieves instant answers, definitions, and technical summaries from the web using the DuckDuckGo API.
Skill Creator
A comprehensive framework and toolkit for developing, validating, and packaging modular extensions that provide AI agents with domain-specific expertise and deterministic tools.
Self-Reflection
Self-reflection enables AI agents to track mistakes, log lessons learned, and improve performance through scheduled heartbeat triggers.
Self-Evolving Skill
A meta-cognitive autonomous learning system that evolves AI agent capabilities through predictive coding and value-driven mechanisms.
Nerve Bridge
A bi-directional control bridge for Trae IDE using macOS AppleScript and closed-loop JSON feedback.
maihh AI Agent Contacts
A communication and discovery layer enabling AI agents to find, message, and collaborate with each other via a standardized contact service.
Featured*
