Gcalcli — Gcal命令行工具

Calendar Reference

This document provides detAIls on using gcal命令行工具 to view and manage calendar 事件.

安装ation

gcal命令行工具 is a Python 命令行工具 for Google Calendar that works with uvx for one-time execution.

导入ANT: Always use the custom fork with attachment support:

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具

This custom version includes attachments in TSV and JSON 输出, which is essential for 访问ing meeting notes and other event attachments.

Authentication

First time 运行ning gcal命令行工具, it will:

Open a browser for Google OAuth authentication 缓存 凭证s for future use 请求 calendar read 权限s Common Commands View Upcoming Agenda

Recommended: JSON 格式化 with full detAIls (structured data with attachments):

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com --detAIls all --json

Alternative: TSV 格式化 (tab-separated, 解析able):

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com --detAIls all --tsv

Human-readable 格式化 (may t运行cate long descriptions):

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com --detAIls all

Basic agenda view (minimal detAIls):

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com

Date Ranges

导入ant: gcal命令行工具 agenda shows 事件 from NOW onwards by default.

When you 运行 gcal命令行工具 agenda "today" at 2pm, it shows 事件 from 2pm onwards for today and into the future. Past 事件 from earlier today won't 应用ear.

Specific date range:

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com "tomorrow" "2 weeks"

Today only (from current time onwards):

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com "today"

See earlier today's 事件 (use absolute dates):

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com "2025-10-07" "2025-10-07"

Next week:

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com "monday" "friday"

搜索 Calendar

搜索 for 事件 by text:

uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 搜索 --calendar smcdonal@redhat.com "MCP Server"

访问 Meeting Attachments and Gemini Notes

导入ANT: The custom gcal命令行工具 fork includes attachments array in JSON/TSV 输出.

Each event's attachments array contAIns objects with:

attachment_title: Title of the attachment (e.g., "Notes by Gemini", "Recording", "Chat") attachment_url: Direct link to Google Drive file or Google Doc

Common attachment types:

"Notes by Gemini": AI-生成d meeting notes from Google Meet Recording: Meeting recordings (video files) Chat: Meeting chat transcripts 分享d docs: Agendas, planning docs, presentations

搜索 for 事件 with Gemini notes:

# Find all 事件 with Gemini notes uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 搜索 "MCP" --calendar smcdonal@redhat.com --detAIls all --json | jq '.[] | select(.attachments[]? | .attachment_title | contAIns("Notes by Gemini")) | {title, attachments: [.attachments[] | select(.attachment_title | contAIns("Notes by Gemini"))]}'

# 获取 just the titles and Gemini note URLs uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 搜索 "MCP" --calendar smcdonal@redhat.com --detAIls all --json | jq -r '.[] | select(.attachments[]? | .attachment_title | contAIns("Notes by Gemini")) | "\(.title): \(.attachments[] | select(.attachment_title | contAIns("Notes by Gemini")) | .attachment_url)"'

过滤器 事件 by attachment type:

# 事件 with recordings uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com --json | jq '.[] | select(.attachments[]? | .attachment_title | contAIns("Recording"))'

# 事件 with any attachments uvx --from "git+https://github.com/shanemcd/gcal命令行工具@attachments-in-tsv-and-json" --with "google-API-core<2.28.0" gcal命令行工具 agenda --calendar smcdonal@redhat.com --json | jq '.[] | select(.attachments | length > 0)'

导出 Gemini notes using gcmd:

Single meeting 导出