outlook-calendar

What This Skill Does

The outlook-calendar skill enables your OpenClaw AI agent to seamlessly integrate with your enterprise Microsoft 365 environment. By authenticating with your corporate credentials, the agent can programmatically access, parse, and summarize your Outlook calendar events. This tool is specifically designed to act as your intelligent personal assistant, converting raw calendar data into actionable insights, such as time management reports, meeting summaries, and scheduling conflicts. It handles the complexity of Microsoft's MFA (Multi-Factor Authentication) and token management, providing a stable interface for natural language queries about your professional commitments.

Installation

Installation is straightforward via the OpenClaw ecosystem. First, run clawhub install openclaw/skills/skills/ilove323/outlook-calendar. Once installed, you must create a configuration file at ~/.outlook/config.json containing your email and authentication preferences. Ensure your environment has the necessary drivers by executing pip install playwright requests and playwright install chromium. Finally, navigate to the skill directory and execute python login.py to initiate the MFA handshake with Microsoft 365. Your session cookies will be safely stored in the ~/.outlook/ directory, keeping sensitive session data outside the main skill folder.

Use Cases

This skill is perfect for professionals who juggle multiple meetings and project deadlines. It excels at parsing recurring agendas, calculating total time spent in meetings to prevent burnout, identifying open time slots for deep work, and summarizing complex weekly schedules. Whether you are prepping for a busy day or reflecting on your monthly productivity, the agent extracts the relevant metadata from your calendar and presents it in a clear, summarized format.

Example Prompts

1. "Hey, what does my schedule look like for tomorrow? I need to know when my first meeting starts."
2. "I have a lot going on this week. Can you summarize all my meetings and calculate how many hours I'll be in calls in total?"
3. "List all the tasks and work-related events I have scheduled for next week so I can prepare accordingly."

Tips & Limitations

• Time Zones: The skill returns raw UTC data. Ensure your agent prompt processing includes a conversion to your local time zone (typically +8 for Shanghai).
• MFA Expiry: Cookies typically expire every 1 to 7 days. If the agent returns [AUTH_FAILED], simply re-run the login script.
• Rate Limiting: Avoid rapid-fire requests to the Microsoft backend. If you encounter rate limits, wait at least 15 minutes before attempting to re-authenticate.
• Data Security: Always keep your ~/.outlook/ directory secured with appropriate file permissions, as it stores your authentication tokens.