@apilium/google-calendar

Google Calendar integration skill for Mayros -- events CRUD, availability, scheduling.

Installation

Copy this skill directory into your Mayros skills folder:

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

Or install via the Mayros CLI:

mayros skill install @apilium/google-calendar

Configuration

This skill requires the gog CLI tool to be installed and authenticated.

Install gog

# macOS
brew install gog

# Linux
curl -fsSL https://get.gog.dev | bash

Authenticate

gog auth login

This opens a browser window for Google OAuth. Once authenticated, gog stores credentials locally.

Usage

Once configured, the agent can:

• List events: View upcoming events from any calendar
• Create events: Schedule new events with time, location, and description
• Update events: Modify existing event details
• Delete events: Remove events from calendars
• Check availability: Query free/busy status across calendars
• Recurring events: Create events with RRULE recurrence patterns

Example prompts

"What meetings do I have today?"
"Schedule a meeting with the team tomorrow at 2pm for 1 hour"
"Am I free on Friday afternoon?"
"Cancel the standup meeting on March 3rd"
"Create a weekly review every Friday at 3pm"

Semantic Predicates

| Predicate | Scope | Description | |-----------|-------|-------------| | calendar:event_created | agent | Events created by the agent | | calendar:event_updated | agent | Events modified by the agent | | calendar:availability_checked | agent | Free/busy queries performed | | calendar:schedule_context | agent | Schedule summary for context enrichment |

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