gcalcli Google Calendar Integration for Openclaw

A powerful CLI tool for interacting with Google Calendar, specialized for extracting meeting notes and event attachments.

gargravish
v0.1.0
Feb 1, 2026
0
4.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install gcalcli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install gcalcli 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 gcalcli Google Calendar Integration?

This skill utilizes a specialized fork of gcalcli to provide advanced Google Calendar management directly from your command line. It is designed to bridge the gap between your schedule and your development environment, allowing for seamless retrieval of event data, meeting links, and structured attachments. As a core component of Openclaw Skills, it focuses on providing machine-readable outputs like JSON and TSV to facilitate automation and data analysis.

Beyond basic scheduling, this implementation prioritizes access to modern collaboration artifacts. It specifically handles Google Meet recordings and AI-generated meeting summaries, making it an essential tool for developers who need to reference meeting context without leaving their terminal or IDE. By integrating this into Openclaw Skills, you gain a calendar-aware assistant capable of preparing you for upcoming syncs or retrieving documentation from past discussions.

gcalcli Google Calendar Integration Use Cases

  • Automated morning agenda reviews that filter for upcoming high-priority meetings.
  • Extracting AI-generated Notes by Gemini directly into your local workspace for documentation.
  • Searching for historical meeting context using project-specific IDs or keywords.
  • Bulk exporting meeting recordings and chat transcripts for project archiving.
  • Identifying deep-work blocks by analyzing gaps between scheduled calendar events.

How gcalcli Google Calendar Integration Works

  1. The skill is invoked via the uvx runner, targeting a specific fork that supports extended attachment metadata.
  2. Upon first execution, it initiates a secure Google OAuth flow to grant the necessary read permissions.
  3. Users query their calendar using commands like agenda or search with specific date ranges or filters.
  4. The tool fetches data from the Google Calendar API v3 and formats it into structured JSON or TSV.
  5. Attachment arrays are processed to identify links for meeting notes, recordings, or shared documents.
  6. The resulting data can be piped into other Openclaw Skills or local utilities like jq and gcmd for further processing.

gcalcli Google Calendar Integration Setup

To use this skill effectively within the Openclaw Skills framework, you must use the custom fork that supports attachments and ensure the correct API core version is pinned.

# Initial setup and first-time authentication
uvx --from "git+https://github.com/shanemcd/gcalcli@attachments-in-tsv-and-json" \
    --with "google-api-core<2.28.0" \
    gcalcli agenda --calendar [email protected] --json

Following the command, a browser window will open for OAuth authentication. Once authorized, credentials are cached locally for future use.

gcalcli Google Calendar Integration Data Schema & Taxonomy

The skill provides highly structured output, particularly when using the --json flag. Below is the organization of the primary data fields:

Field Type Description
title String The summary or name of the calendar event.
s / e ISO8601 Start and end timestamps for the event.
attachments Array Objects containing attachment_title and attachment_url.
description String The full body text of the calendar invite.
location String Physical location or virtual meeting link.
attendees Array List of participants and their RSVP status (with --details all).

Specialized attachment titles include "Notes by Gemini", "Recording", and "Chat", allowing for targeted extraction of meeting artifacts.

gcalcli Google Calendar Integration Advanced Features

  • Parallel processing support: Use xargs to bulk-export Gemini notes across multiple meetings simultaneously.
  • Complex filtering: Combine with jq to select events only if they contain specific attachment types like video recordings.
  • Natural language date parsing: Supports flexible ranges such as "2 weeks ago", "next monday", or "today".
  • Multi-format support: Switch between JSON for automation and TSV for classic Unix command-line processing.
  • Detailed metadata access: Use the --details all flag to retrieve full attendee lists and response statuses for coordination.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*