@apilium/outlook-calendar

Outlook Calendar integration skill for Mayros -- events, scheduling, free/busy via Microsoft Graph API.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/outlook-calendar ~/.mayros/skills/outlook-calendar

Or install via the Mayros CLI:

mayros skill install @apilium/outlook-calendar

Configuration

This skill requires a Microsoft Graph API access token.

Set the access token

export MS_GRAPH_ACCESS_TOKEN="your-token-here"

Quick token via Azure CLI

If you have the Azure CLI installed:

export MS_GRAPH_ACCESS_TOKEN="$(az account get-access-token --resource https://graph.microsoft.com --query accessToken -o tsv)"

Required permissions (delegated)

• Calendars.Read
• Calendars.ReadWrite

Usage

Once configured, the agent can:

• List events: View upcoming calendar events
• Create events: Schedule new events with attendees, location, and timezone
• Update events: Modify existing event details
• Delete events: Remove events (with user confirmation)
• Check availability: Query free/busy status for scheduling
• List calendars: View all available calendars

Example prompts

"What meetings do I have today?"
"Schedule a meeting with Alice tomorrow at 2pm for 1 hour"
"Am I free on Friday afternoon?"
"Cancel the standup meeting on March 3rd"
"Check if Bob is available next Tuesday morning"

Semantic Predicates

Temporal Annotations

The skill automatically annotates query results with temporal context:

• past -- Event has already ended
• today -- Event occurs today
• upcoming -- Event is within the next 7 days
• far_future -- Event is more than 7 days away
• imminent -- Event starts within 1 hour

License

MIT