A comprehensive toolset for managing Microsoft Outlook and Hotmail email and calendar services through the Microsoft Graph API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install outlook
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 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?
This skill provides a robust interface for AI agents to interact directly with Microsoft Outlook, Hotmail, and Office 365 accounts. By utilizing the Microsoft Graph API and OAuth2 authentication, it allows for secure, programmatic access to inbox management and scheduling. As a key component of Openclaw Skills, this integration enables agents to read, search, and organize communications while maintaining a high level of security through local credential storage.
Beyond simple email reading, the skill converts HTML bodies to plain text, ensuring that AI models can process message content efficiently. It bridges the gap between raw API data and actionable insights, making it an essential tool for developers building autonomous assistants that need to handle real-world communication and scheduling tasks.
Outlook Use Cases
- Automating inbox triaging by filtering, flagging, and moving emails to specific folders.
- Searching through extensive email histories to find specific documents or data points for research tasks.
- Managing complex schedules by checking availability and creating calendar events via natural language commands.
- Drafting and sending professional replies or new emails directly through an agent interface.
How Outlook Works
- The user executes the automated setup script to link the skill with an Azure App Registration.
- OAuth2 tokens are retrieved via the device code flow and stored securely in the user's home directory.
- Scripts for mail and calendar functions call the Microsoft Graph API using the stored access tokens.
- For email operations, the skill fetches message metadata or content, automatically converting HTML to a readable plain text format.
- Calendar operations allow for the retrieval of upcoming events or the creation of new appointments with specific time zones.
- A token refresh mechanism ensures that the connection remains active even after the initial session expires.
Outlook Setup
To deploy this within the Openclaw Skills ecosystem, you need the Azure CLI and jq installed. Run the following command to start the automated configuration:
./scripts/outlook-setup.sh
This script will log you into Azure, create the necessary App Registration, and configure permissions including Mail.ReadWrite and Calendars.ReadWrite. Follow the on-screen instructions to complete the OAuth2 authorization. Your configuration and tokens will be saved to ~/.outlook-mcp/.
Outlook Data Schema & Taxonomy
The skill manages configuration and session data locally while providing structured JSON output for all API interactions.
| Component | Path / Structure | Description |
|---|---|---|
| Configuration | ~/.outlook-mcp/config.json |
Stores the Azure Client ID and Secret. |
| Credentials | ~/.outlook-mcp/credentials.json |
Stores active OAuth2 access and refresh tokens. |
| Email Data | { "subject", "from", "date", "read", "id" } |
Structured JSON representing email messages. |
| Calendar Data | { "subject", "start", "end", "location", "id" } |
Structured JSON representing scheduled events. |
| ID Handling | Unique 20-char Suffix | Uses the last 20 characters of the Microsoft ID for easier CLI reference. |
Outlook Advanced Features
- Automatic HTML-to-Plain Text extraction to optimize token usage for AI models.
- Integrated availability checking to find free time slots for scheduling meetings.
- Support for both personal Microsoft accounts and enterprise Microsoft 365 accounts.
- Multi-folder management including archiving, moving, and trash operations.
- Robust error handling for common API issues like expired tokens or insufficient privileges.
SKILL.md
Loading
Related Openclaw Skills
Whisper Transcribe
A versatile speech-to-text utility that leverages OpenAI Whisper to transcribe audio and video files into multiple subtitle and text formats.
Universal Notify
A unified notification script that sends alerts across multiple platforms like Telegram, ntfy, and SMTP through a single interface.
Pi Health Monitor
A lightweight diagnostics script to monitor thermal performance, power stability, and resource usage on Raspberry Pi hardware.
Dokploy Deployment Management
A comprehensive interface to programmatically manage Dokploy projects, deployments, and infrastructure through its native API.
x402-direct
A specialized directory for discovering and searching crypto-native, x402-enabled API services designed for autonomous agents.
Xiaohongshu Extract
A high-performance script to scrape metadata, user info, and video details from Xiaohongshu share or discovery URLs.