A professional-grade CLI integration for managing cross-calendar availability and event tracking via the gog utility.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install calendar-query
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install calendar-query using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Calendar Query?
The Calendar Query skill is a specialized tool designed for the Openclaw Skills ecosystem that enables automated, high-precision interaction with Google Calendar accounts. By leveraging the gog CLI, this skill allows for deep querying of event data across multiple professional and personal accounts, ensuring that scheduling conflicts are avoided and availability is always accurate.
This skill is particularly effective for users managing complex schedules, as it enforces a prioritized retrieval logic. It emphasizes primary work calendars while providing context from personal schedules, allowing an AI agent to act as a comprehensive executive assistant that understands the nuances of a user's entire day.
Calendar Query Use Cases
- Automated daily standup preparation by listing all work-related events for the current day.
- Checking cross-calendar availability to find optimal meeting windows without manual toggling.
- Keyword-based searching for specific events like travel itineraries, sports games, or project milestones.
- Managing relative date ranges for weekly planning or multi-day schedule summaries.
How Calendar Query Works
- The AI agent receives a natural language prompt regarding scheduling or availability.
- The skill executes the gog CLI utility using pre-authenticated credentials.
- It queries the primary work calendar (matt.williams@flowcode.com) using ISO-formatted timestamps for precision.
- A secondary query is performed against the personal calendar (williams.e.matt@gmail.com) to gather broader context.
- The skill merges these datasets, prioritizing work events chronologically before appending personal notes.
- A structured summary is returned to the user, highlighting all-day events and specific time slots.
Calendar Query Setup
To integrate this into your environment, ensure the gog CLI is installed and authenticated. Within the Openclaw Skills framework, configure your calendars as follows:
# Example: List work events for a specific date
gog calendar events [email protected] --from "2026-03-18T00:00:00" --to "2026-03-18T23:59:59"
# Example: Search personal calendar for specific keywords
gog calendar events [email protected] --query "Flight" --days 30
Calendar Query Data Schema & Taxonomy
The skill processes calendar data using the following organizational structure:
| Attribute | Description | Data Type |
|---|---|---|
| calendar_id | The email address associated with the specific Google Calendar. | String |
| timeframe | ISO 8601 timestamps used for precise range filtering. | DateTime |
| query_type | Categorization of request (events, relative range, or keyword search). | Enum |
| response_priority | Tiered output logic (Work Calendar > Personal Calendar). | Logic Path |
Calendar Query Advanced Features
- Support for relative date ranges using flags like --tomorrow, --today, or --week for rapid querying.
- Narrowed window querying for specific time blocks (e.g., afternoon-only availability).
- Integrated error handling that captures gog CLI output for troubleshooting and re-authentication prompts.
- Multi-calendar merging logic that synthesizes fragmented data into a cohesive chronological daily view.
SKILL.md
Loading
Related Openclaw Skills
Salespype
A comprehensive Salespype integration that allows AI agents to manage sales pipelines, track leads, and handle customer interactions programmatically.
Team-Collab: Multi-Model AI Team Orchestration
An advanced multi-model orchestration system that transforms AI agents into a full-scale professional team covering development, design, and legal compliance.
TickTick Task Management
A comprehensive task management skill for TickTick that allows users to handle projects, tasks, and configurations directly through an AI-powered CLI workflow.
Kite Suite Skill
A comprehensive sales engagement and project management integration for automating outreach, tracking tasks, and managing workspace data via Membrane.
Gadget Skill
An expert AI skill providing smart home reviews, hardcore tech evaluations, and geek-level buying advice.
ETermin Integration for AI Agents
A comprehensive Openclaw Skills integration for managing ETermin appointments, availability, and customer data via AI agents.
Featured*
