How do I install the Google Calendar skill?

Run npx skillmds@latest add luokai0/google-calendar-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Google Calendar safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Calendar?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Google Calendar free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Google Calendar?

luokai0 (@luokai0) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Google Calendar by luokai0 — Agent Skill

Name: Google Calendar
Rating: 4.2 (5 reviews)
Author: luokai0

Google Calendar

Query Google Calendar for events and free time blocks. Requires google-direct-oauth skill to be set up first. Ask Zo things like "what's on my calendar today", "find free time tomorrow", "show my week", or "when am I free on Friday between 10am and 4pm".

luokai0 Updated Sep 9, 2026 10 repo stars

File contents

Google Calendar Skill

Query your calendar and find free time using your direct Google OAuth connection.

Prerequisites

Set up the google-direct-oauth skill first. You should have valid tokens at /home/.z/google-oauth/token.json. These credentials can also be reused by gog if you install that external skill.

Usage

The main script is scripts/gcal.py. Run with --help for all options:

python Skills/google-calendar/scripts/gcal.py --help

List Events

# Today's events
python scripts/gcal.py events

# Specific date
python scripts/gcal.py events 2026-01-25
python scripts/gcal.py events tomorrow
python scripts/gcal.py events "next monday"

Find Free Time

# Free blocks today (9am-6pm, min 15 min)
python scripts/gcal.py free

# Custom hours
python scripts/gcal.py free tomorrow --start 10 --end 16

# Longer blocks only
python scripts/gcal.py free friday --min-duration 60

Week Overview

python scripts/gcal.py week

JSON Output (for programmatic use)

python scripts/gcal.py json today

For Zo

When the user asks about their calendar:

"What's on my calendar [date]?" → Run events command
"When am I free [date]?" → Run free command
"Show my week" → Run week command
"Find me a 1-hour slot tomorrow afternoon" → Run free tomorrow --start 12 --end 18 --min-duration 60

Parse natural language dates:

"today", "tomorrow", "yesterday"
"next monday", "next friday"
"January 25" → "01-25"
"2026-01-25"

Frequently asked questions