← Back to Skills Marketplace
Google Calendar (via gcalcli)
by
Nikita Shkoda
· GitHub ↗
· v3.0.0
16374
Downloads
10
Stars
114
Active Installs
11
Versions
Install in OpenClaw
/install gcalcli-calendar
Description
Google Calendar via gcalcli: today-only agenda by default, bounded meaning-first lookup via agenda scans, and fast create/delete with verification--optimized for low tool calls and minimal output.
Usage Guidance
Install this only if you are comfortable letting an agent use your authenticated gcalcli profile to read and change your Google Calendar. Pay particular attention to the documented policy that a clearly matched delete or edit request can run without a second confirmation; change that policy to always ask first if you prefer stricter control.
Capability Analysis
Type: OpenClaw Skill
Name: gcalcli-calendar
Version: 3.0.0
The skill bundle is benign. It provides instructions for an AI agent to manage Google Calendar using the `gcalcli` command-line tool. All files clearly document the skill's purpose, usage, and underlying commands. The `SKILL.md` details a specific 'Actions policy' that skips confirmation for unambiguous actions, but this is explicitly stated as a deliberate UX choice with multiple safety guards (e.g., explicit user request, single unambiguous match, post-action verification, overlap checks for creates). There is no evidence of data exfiltration, malicious execution, persistence mechanisms, obfuscation, or prompt injection attempts designed to subvert the agent for harmful purposes. The `README.md` further clarifies network access (only Google Calendar API via gcalcli) and lists all used commands, reinforcing transparency.
Capability Assessment
Purpose & Capability
The stated purpose is Google Calendar management, and the artifacts consistently describe reading, searching, creating, importing, editing by delete-and-recreate, and deleting calendar events via gcalcli. These are sensitive account actions, but they match the purpose and are disclosed.
Instruction Scope
The skill uses bounded agenda/search windows, asks for disambiguation on multiple or uncertain matches, checks overlaps before creating events, and verifies deletes. It intentionally skips an extra confirmation for explicit, unambiguous destructive requests, which is a real usability-risk tradeoff but is clearly documented and scoped.
Install Mechanism
The bundle contains only README.md and SKILL.md markdown instructions and no executable installer or scripts. It requires a separately installed gcalcli binary, with pip or brew mentioned as setup options.
Credentials
Access to Google Calendar and local gcalcli OAuth credentials is expected for this integration. The README documents the Google Calendar and OAuth endpoints used through gcalcli and states that no other network access is made.
Persistence & Privilege
The skill itself adds no background worker, persistence mechanism, or credential store. Privilege comes from the user's existing local gcalcli OAuth profile, which allows the agent to mutate calendar data when instructed.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gcalcli-calendar - After installation, invoke the skill by name or use
/gcalcli-calendar - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.0.0
- Added a README.md file with rationale and safety notes.
- Clarified action confirmation policy: unambiguous destructive actions (delete/edit) are run immediately, ambiguous ones always require user confirmation.
- Updated action policy section to emphasize conversational speed and personal assistant use case.
- Renamed/delete section now explicitly describes post-delete verification and the use of `--iamaexpert`.
- No behavior changes to commands, but documentation is clearer about UX intent and safeguards.
v2.1.2
- Removed internal metadata file (_meta.json) from the skill package.
- No changes to functional logic or user-facing features.
v2.1.1
Version 2.1.1
- Added _meta.json file for improved metadata management.
- No changes to existing skill logic or behavior.
v2.1.0
**Summary:** Adds explicit rules for CLI flag placement and event creation methods.
- Enforces that global CLI flags (like --nocolor, --calendar) must precede the subcommand; subcommand-specific flags come after (e.g., gcalcli --nocolor delete --iamaexpert ...).
- Provides guidance on choosing the correct event creation method: "add" for most events, "import" via stdin for recurring/free events, and avoid "quick" unless explicitly requested.
- Documents flag placement requirements for all subcommands (delete, add, import, etc.).
- Clarifies that for ICS imports, events must be piped via stdin and not via temporary files.
- Updates canonical command examples to reflect these rules.
v2.0.2
- Short summary: Event creation now checks for overlaps across all non-ignored calendars, not just the target calendar.
- Overlap checks before creating events now always scan the full agenda (without filtering by calendar), ensuring conflicts from any visible calendar are detected.
- Updated documentation to clarify that cross-calendar checking is required for create actions.
- Minor edits and clarifications to rules and canonical commands.
v2.0.1
- Updated skill description for greater clarity and brevity.
- No file or logic changes; internal policies, rules, and commands remain unchanged.
v2.0.0
Update version in ClawHub
v1.0.1
- Changed default agenda behavior: “agenda” without a period now shows only today.
- Unambiguous cancel/delete/edit actions now run immediately without confirmation; confirmation is only required if multiple candidates exist.
- Event creation only asks for confirmation if overlapping events are found; otherwise, events are created directly.
- [IMPORTANT] Deletes now use non-interactive mode with post-action verification and one retry if needed. If "confirm before delete" behavior is desired, you should adjust the corresponding skill rule.
- Responses are more concise; CLI commands are only shown when explicitly requested by the user.
- Improved handling and parsing rules for matching events, focusing on agenda scans over search for meaning-first, deterministic results.
- Overall tokens usage cuts.
v1.0.0
gcalcli-calendar 0.1.2
- Clarified scope usage: Only mention calendar scope and search window if no events are found.
- Response output is now even more concise—omit scope when events are found.
- Reorganized and simplified hard rules for brevity and clarity.
- Default agenda/search periods and response behaviors are more explicit.
- Calendar listing and scope debugging triggered only by user request or when results are unexpectedly empty.
v0.1.1
- Fix description in YAML frontmatter which prevented skill discovery
v0.1.0
gcalcli-calendar 0.1.0
- Initial release providing fast agenda (today/week/range), bounded keyword search, and safe event actions using `gcalcli`.
- Respects config-scoped `default-calendars` and `ignore-calendars` for reliable multi-calendar support.
- All searches and agendas use explicit, well-defined time windows (defaults to next ~6 months).
- Output is minimal and parse-friendly (`--nocolor`), optimized for both users and automated agents.
- All write actions (add/edit/delete) require explicit confirmation, summarizing proposed changes before execution.
- Clearly communicates scope of search/results, encouraging user-driven expansion when no matches are found.
Metadata
Frequently Asked Questions
What is Google Calendar (via gcalcli)?
Google Calendar via gcalcli: today-only agenda by default, bounded meaning-first lookup via agenda scans, and fast create/delete with verification--optimized for low tool calls and minimal output. It is an AI Agent Skill for Claude Code / OpenClaw, with 16374 downloads so far.
How do I install Google Calendar (via gcalcli)?
Run "/install gcalcli-calendar" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Google Calendar (via gcalcli) free?
Yes, Google Calendar (via gcalcli) is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Google Calendar (via gcalcli) support?
Google Calendar (via gcalcli) is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Google Calendar (via gcalcli)?
It is built and maintained by Nikita Shkoda (@lstpsche); the current version is v3.0.0.
More Skills