How do I install the Gcal skill?

Run npx skillmds@latest add majiayu000/gcal 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.

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

Which AI agents work with Gcal?

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.

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

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

Gcal by majiayu000 — Agent Skill

Name: Gcal
Rating: 4.5 (4 reviews)
Author: majiayu000

File contents

Google Calendar CLI (gccli)

You have access to gccli - a minimal Google Calendar CLI. All commands use the format:

gccli <email> <command> [options]

Available Accounts

Commands

List Calendars

gccli <email> calendars

Returns: ID, name, access role.

List Events

gccli <email> events <calendarId> [options]

Options:

--from <datetime> - Start time (ISO 8601, default: now)
--to <datetime> - End time (ISO 8601, default: 1 week from now)
--max <n> - Max results (default: 10)
--query <q> - Free text search

Examples:

gccli ben@factory.ai events primary
gccli ben@factory.ai events primary --from 2024-01-01T00:00:00Z --max 50
gccli ben@factory.ai events primary --query "meeting"

Get Event Details

gccli <email> event <calendarId> <eventId>

Create Event

gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt> [options]

Options:

--summary <s> - Event title (required)
--start <datetime> - Start time (required, ISO 8601)
--end <datetime> - End time (required, ISO 8601)
--description <d> - Event description
--location <l> - Event location
--attendees <emails> - Attendees (comma-separated)
--all-day - Create all-day event (use YYYY-MM-DD for start/end)

Examples:

gccli ben@factory.ai create primary --summary "Meeting" --start 2024-01-15T10:00:00 --end 2024-01-15T11:00:00
gccli ben@factory.ai create primary --summary "Vacation" --start 2024-01-20 --end 2024-01-25 --all-day
gccli ben@factory.ai create primary --summary "Team Sync" --start 2024-01-15T14:00:00 --end 2024-01-15T15:00:00 --attendees a@x.com,b@x.com

Update Event

gccli <email> update <calendarId> <eventId> [options]

Options: same as create (all optional).

Delete Event

gccli <email> delete <calendarId> <eventId>

Check Free/Busy

gccli <email> freebusy <calendarIds> --from <dt> --to <dt>

Calendar IDs are comma-separated.

Example:

gccli ben@factory.ai freebusy primary,work@group.calendar.google.com --from 2024-01-15T00:00:00Z --to 2024-01-16T00:00:00Z

List Access Control Rules

gccli <email> acl <calendarId>

Returns: scope type, scope value, role.

Notes

Use primary as calendarId to reference the main calendar
Date/times should be ISO 8601 format (e.g., 2024-01-15T10:00:00 or 2024-01-15T10:00:00Z)
For all-day events, use date format YYYY-MM-DD

---name: gcaldescription: Google Calendar CLI for listing calendars, managing events, and checking availability. Use when you need to view, create, update, or delete calendar events, check free/busy status, or list calendars.--- # Google Calendar CLI (gccli) You have access to `gccli` - a minimal Google Calendar CLI. All commands use the format: ```bash gccli <email> <command> [options] ``` ## Available Accounts - ben.tossell@gmail.com - ben@bensbites.com - ben@factory.ai ## Commands ### List Calendars ```bash gccli <email> calendars ``` Returns: ID, name, access role. ### List Events ```bash gccli <email> events <calendarId> [options] ``` Options: - `--from <datetime>` - Start time (ISO 8601, default: now) - `--to <datetime>` - End time (ISO 8601, default: 1 week from now) - `--max <n>` - Max results (default: 10) - `--query <q>` - Free text search Examples: ```bash gccli ben@factory.ai events primary gccli ben@factory.ai events primary --from 2024-01-01T00:00:00Z --max 50 gccli ben@factory.ai events primary --query "meeting" ``` ### Get Event Details ```bash gccli <email> event <calendarId> <eventId> ``` ### Create Event ```bash gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt> [options] ``` Options: - `--summary <s>` - Event title (required) - `--start <datetime>` - Start time (required, ISO 8601) - `--end <datetime>` - End time (required, ISO 8601) - `--description <d>` - Event description - `--location <l>` - Event location - `--attendees <emails>` - Attendees (comma-separated) - `--all-day` - Create all-day event (use YYYY-MM-DD for start/end) Examples: ```bash gccli ben@factory.ai create primary --summary "Meeting" --start 2024-01-15T10:00:00 --end 2024-01-15T11:00:00 gccli ben@factory.ai create primary --summary "Vacation" --start 2024-01-20 --end 2024-01-25 --all-day gccli ben@factory.ai create primary --summary "Team Sync" --start 2024-01-15T14:00:00 --end 2024-01-15T15:00:00 --attendees a@x.com,b@x.com ``` ### Update Event ```bash gccli <email> update <calendarId> <eventId> [options] ``` Options: same as create (all optional). ### Delete Event ```bash gccli <email> delete <calendarId> <eventId> ``` ### Check Free/Busy ```bash gccli <email> freebusy <calendarIds> --from <dt> --to <dt> ``` Calendar IDs are comma-separated. Example: ```bash gccli ben@factory.ai freebusy primary,work@group.calendar.google.com --from 2024-01-15T00:00:00Z --to 2024-01-16T00:00:00Z ``` ### List Access Control Rules ```bash gccli <email> acl <calendarId> ``` Returns: scope type, scope value, role. ## Notes - Use `primary` as calendarId to reference the main calendar - Date/times should be ISO 8601 format (e.g., 2024-01-15T10:00:00 or 2024-01-15T10:00:00Z) - For all-day events, use date format YYYY-MM-DD

Frequently asked questions

Gcal