← Back to Skills Marketplace
61
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install google-calendar-find-event
Description
Atomic node skill to search for events in Google Calendar using the gog CLI.
README (SKILL.md)
Lean Philosophy (Principles)
- Kaizen (改善): This skill is an atomic node, broken down into its simplest, smallest component to eliminate waste and ensure perfection.
- Standardized Work (Hyojun Sagyo): This node represents the most efficient, standardized path for this specific task before automation.
- Jidoka (自働化): This node includes autonomous defect detection. It relies on the CLI's self-healing loop and will report errors if the search fails.
Google Calendar Find Event
This skill allows the agent to search for events in Google Calendar within a specific time range using the native CLI.
Cognitive Directives
WHEN [Requested to find events or check schedule for a specific period or subject]
THEN [Execute the gog tool with the args parameter]
CRITICAL RULE: Do NOT use the --subject flag, it does not exist. To search for a specific title or subject, you MUST use the --query "Search Term" flag.
Schema Example
{
"args": "calendar events primary --from \"2026-04-26T00:00:00Z\" --to \"2026-04-26T23:59:59Z\" --query \"Meeting Title\" --json"
}
Expected Output
A JSON array of event objects matching the criteria.
Usage Guidance
This skill runs the local 'gog' CLI with the provided args to return calendar events as JSON. Before installing, ensure: (1) you trust the agent that will invoke this skill because it will use your existing 'gog' authentication (calendar access) on the host; (2) 'gog' is installed and authenticated to the correct Google account; (3) callers are restricted from supplying arbitrary 'args' if you want to limit the skill strictly to read-only calendar queries. If you need least privilege, consider using a dedicated, read-only account or service credentials with limited scope instead of broad personal credentials.
Capability Analysis
Type: OpenClaw Skill
Name: google-calendar-find-event
Version: 1.0.3
The skill is a standard wrapper for the 'gog' CLI tool, designed to search Google Calendar events. It contains no executable code or suspicious instructions, and its behavior is strictly aligned with its stated purpose as described in SKILL.md.
Capability Assessment
Purpose & Capability
The skill's name and description claim to search Google Calendar via the 'gog' CLI and the SKILL.md only requires the 'gog' binary and shows a calendar-specific args example — this is proportionate and expected.
Instruction Scope
The SKILL.md directs the agent to execute the 'gog' tool with an 'args' string (example: calendar events ... --json). This stays within the stated purpose, but the 'args' field is freeform; if the agent or caller supplies arbitrary args it could invoke other 'gog' commands beyond calendar reads. Practically, the skill itself doesn't instruct broad file reads or unrelated env access.
Install Mechanism
There is no install spec and no code files — the skill is instruction-only and relies on an existing 'gog' binary on PATH, which is the lowest-risk install model.
Credentials
The skill declares no required environment variables or credentials. This is consistent because 'gog' will use whatever local authentication/configuration is already present. Be aware this implicitly uses the user's existing gog auth (and thus Google account access) for calendar reads.
Persistence & Privilege
The skill does not request permanent presence (always=false), does not modify system or other skills' configs, and is user-invocable/autonomously invokable by default — which is normal for skills.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install google-calendar-find-event - After installation, invoke the skill by name or use
/google-calendar-find-event - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
- Added specific instruction not to use the `--subject` flag; clarified that searching by title/subject must use the `--query` flag.
- Updated Cognitive Directives to include requests by subject, and adjusted usage examples.
- Provided a corrected schema example demonstrating the `--query` usage for event title search.
v1.0.3
- Updated command usage instructions to use the gog tool with the args parameter instead of full CLI commands.
- Revised schema example to reflect the new args-based approach.
- Clarified cognitive directives for increased consistency.
v1.0.2
- Switched integration from the GoogleWorkspace plugin to the gog CLI for searching calendar events.
- Updated requirements: now depends on the presence of the "gog" binary instead of a plugin.
- Revised usage instructions: specifies terminal commands using the gog CLI.
- Updated schema example and expected output to match new CLI integration.
v1.0.1
- Updated supported operating systems from "windows" to "all".
- No functional changes; documentation update only.
v1.0.0
Google Calendar Find Event v1.0.0
- Initial release of an atomic skill to search for events in Google Calendar via the GoogleWorkspace plugin.
- Supports searching within a specified time range using query, timeMin, and timeMax parameters.
- Returns a JSON array of matching event objects.
- Incorporates Lean principles for efficient, standardized, and autonomous error handling.
Metadata
Frequently Asked Questions
What is Google Calendar Find Event?
Atomic node skill to search for events in Google Calendar using the gog CLI. It is an AI Agent Skill for Claude Code / OpenClaw, with 61 downloads so far.
How do I install Google Calendar Find Event?
Run "/install google-calendar-find-event" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Google Calendar Find Event free?
Yes, Google Calendar Find Event is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Google Calendar Find Event support?
Google Calendar Find Event is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Google Calendar Find Event?
It is built and maintained by zvirb (@zvirb); the current version is v1.0.3.
More Skills