A professional integration skill for reading Microsoft 365 Outlook calendar events and emails via automated scripts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install owa-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 owa-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 OWA Outlook Integration?
The owa-outlook skill is designed to bridge the gap between AI agents and enterprise Microsoft 365 environments. By leveraging this integration within Openclaw Skills, users can grant their agents the ability to query meeting schedules, check unread emails, and search through inbox histories. It uses a robust authentication layer that handles enterprise-level security while providing a clean CLI-based interface for data retrieval.
This skill is particularly valuable for developers building personal assistants or productivity tools that require real-time access to corporate communication and scheduling data. It streamlines the process of fetching time-sensitive information, such as today's meetings or urgent unread messages, making it an essential component of a high-performance workspace.
OWA Outlook Integration Use Cases
- Querying daily, weekly, or monthly meeting schedules and appointment details.
- Checking for new or unread emails and summarizing recent inbox activity.
- Searching for specific emails based on keywords, subjects, or senders.
- Monitoring enterprise calendars to prevent scheduling conflicts during automated planning.
- Exporting email and calendar data in JSON format for further processing by other Openclaw Skills.
How OWA Outlook Integration Works
- The skill initializes by reading sensitive credentials and configuration settings from a secure local directory.
- A Playwright-based authentication script logs into the Microsoft 365 portal to establish a valid session.
- Multi-Factor Authentication (MFA) is handled via the Microsoft Authenticator app, where the script displays a matching number for user approval.
- Once authenticated, cookies and Bearer tokens are cached locally to allow for seamless, non-interactive access for up to 7 days.
- Specialized Python scripts (
owa_calendar.pyandowa_mail.py) are invoked to fetch specific data points using the active session tokens. - The retrieved data is formatted and passed back to the AI agent to answer user queries accurately.
OWA Outlook Integration Setup
First, create a configuration file at ~/.outlook/config.json with your credentials:
{
"email": "[email protected]",
"password": "your_password",
"cookie_file": "/root/.outlook/cookies.json",
"cookie_max_age_days": 7,
"mfa_type": "authenticator_number_match"
}
Next, install the required Python dependencies and the Playwright browser engine:
pip install playwright requests
playwright install chromium
Finally, perform the initial MFA login to generate the necessary tokens:
cd ~/.agents/skills/owa-outlook
python login.py
Follow the on-screen instructions to approve the login on your mobile device.
OWA Outlook Integration Data Schema & Taxonomy
The skill organizes its data and configuration across two primary locations to ensure security and efficiency:
| Location | File | Purpose |
|---|---|---|
~/.outlook/ |
config.json |
Stores account email, password, and MFA settings. |
~/.outlook/ |
cookies.json |
Stores persistent session cookies for the OWA portal. |
~/.outlook/ |
token.json |
Caches the Bearer Token for API-based requests. |
| Skill Dir | owa_calendar.py |
Handles date-based logic for fetching calendar events. |
| Skill Dir | owa_mail.py |
Handles filtering and searching logic for emails. |
OWA Outlook Integration Advanced Features
- Zero-touch token refreshing: Automatically updates expired tokens without requiring user re-authentication.
- Native MFA Support: Integrated workflow for Microsoft Authenticator number-matching protocols.
- Flexible Timezone Handling: Handles UTC to local time conversions for accurate schedule reporting.
- Granular Search: Supports searching by specific folders (e.g., Inbox, Sent) and custom result limits.
- Developer Friendly Output: Includes a
--jsonflag to return raw data, making it compatible with complex workflows involving multiple Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Outlook Calendar Integration
A specialized skill enabling AI agents to securely access, read, and summarize Microsoft 365 Outlook calendar events and schedules.
Excel Translator
A professional tool for translating Excel spreadsheets from English to Chinese while maintaining all original cell formatting and visual elements.
Calendar Reminder
A proactive scheduling assistant that bridges Outlook calendars with Lark notifications for intelligent daily reminders using Openclaw Skills.
Mee6 Discord Bot Controller
A specialized skill enabling AI agents to control the Mee6 Discord bot for leveling, moderation, and plugin management.
Tech Investment Daily
An automated agent that generates and pushes deep-dive technology investment reports based on real-time news and market data.
Strapi CMS
A powerful automation skill for managing Strapi headless CMS content, media assets, and system configurations via the official SDK.
METADATA
Featured*
