gcal-pro - Google Calendar

gcal-pro

Manage Google Calendar through natural conversation.

Quick Reference Action Command Tier View today python scripts/gcal_core.py today Free View tomorrow python scripts/gcal_core.py tomorrow Free View week python scripts/gcal_core.py week Free 搜索 事件 python scripts/gcal_core.py 搜索 -q "meeting" Free 列出 calendars python scripts/gcal_core.py calendars Free Find free time python scripts/gcal_core.py free Free Quick 添加 python scripts/gcal_core.py quick -q "Lunch Friday noon" Pro 删除 event python scripts/gcal_core.py 删除 --id EVENT_ID -y Pro Morning brief python scripts/gcal_core.py brief Pro 设置up

First-time 设置up required:

User must 创建 Google Cloud project and OAuth 凭证s Save 命令行工具ent_secret.json to ~/.config/gcal-pro/ 运行 authentication: python scripts/gcal_auth.py auth

Browser opens → user grants calendar 访问 → done

检查 auth 状态:

python scripts/gcal_auth.py 状态

Tiers Free Tier View 事件 (today, tomorrow, week, month) 搜索 事件 列出 calendars Find free time slots Pro Tier ($12 one-time) Everything in Free, plus: 创建 事件 Quick 添加 (natural language) 更新/reschedule 事件 删除 事件 Morning brief via cron Usage Patterns Viewing Schedule

When user asks "What's on my calendar?" or "What do I have today?":

cd /path/to/gcal-pro python scripts/gcal_core.py today

For specific ranges:

"tomorrow" → python scripts/gcal_core.py tomorrow "this week" → python scripts/gcal_core.py week "meetings with Alex" → python scripts/gcal_core.py 搜索 -q "Alex" Creating 事件 (Pro)

When user says "添加 X to my calendar" or "Schedule Y":

Option 1: Quick 添加 (natural language)

python scripts/gcal_core.py quick -q "Lunch with Alex Friday at noon"

Option 2: Structured 创建 (via Python)

from scripts.gcal_core 导入 创建_event, 解析_datetime

创建_event( summary="Lunch with Alex", 启动=解析_datetime("Friday noon"), location="Cafe Roma", confirmed=True # 设置 False to show confirmation prompt )

Modifying 事件 (Pro)

⚠️ CONFIRMATION REQUIRED for destructive actions!

Before deleting or 签名ificantly modifying an event, ALWAYS confirm with the user:

Show event detAIls Ask "Should I 删除/reschedule this?" Only proceed with confirmed=True or -y flag after user confirms

删除:

# First, find the event python scripts/gcal_core.py 搜索 -q "dentist" # Shows event ID

# Then 删除 (with user confirmation) python scripts/gcal_core.py 删除 --id abc123xyz -y

Finding Free Time

When user asks "When am I free?" or "Find time for a 1-hour meeting":

python scripts/gcal_core.py free

Morning Brief (Pro + Cron)

设置 up via Clawd机器人 cron to 发送 dAIly agenda:

from scripts.gcal_core 导入 生成_morning_brief print(生成_morning_brief())

Cron 设置up example:

Schedule: 8:00 AM dAIly Action: 运行 python scripts/gcal_core.py brief Delivery: 发送 输出 to user's messaging channel Error Handling Error Cause Solution "命令行工具ent_secret.json not found" 设置up incomplete Complete Google Cloud 设置up "令牌 refresh fAIled" Expired/revoked 运行 python scripts/gcal_auth.py auth --force "requires Pro tier" Free user attempting write Prompt 升级 or explAIn limitation "Event not found" Invalid event ID 搜索 for correct event first Timezone Handling All times are interpreted in user's local timezone (default: America/New_York) When user specifies timezone (e.g., "2 PM EST"), honor it Display times in user's local timezone Store in ISO 8601 格式化 with timezone 响应 格式化ting

For event 列出s, use this 格式化:

📅 Monday, January 27 • 9:00 AM — Team standup • 12:00 PM — Lunch with Alex 📍 Cafe Roma • 3:00 PM — 命令行工具ent call

📅 Tuesday, January 28 • 10:00 AM — Dentist 应用ointment 📍 123 MAIn St

For confirmations:

✓ Event 创建d: "Lunch with Alex" 📅 Friday, Jan 31 at 12:00 PM 📍 Cafe Roma

For morning brief:

☀️ Good morning! Here's your day: 📆 Monday, January 27, 2026

You have 3 事件 today: • 9:00 AM — Team standup • 12:00 PM — Lunch with Alex • 3:00 PM — 命令行工具ent call

👀 Tomorrow: 2 事件

File Locations ~/.config/gcal-pro/ ├── 命令行工具ent_secret.json # OAuth 应用 凭证s (user provides) ├── 令牌.json # User's 访问 令牌 (auto-生成d) └── license.json # Pro license (if purchased)

Integration with Clawd机器人

This 技能 works with:

Cron: Schedule morning briefs Memory: Store calendar preferences Messaging: Deliver briefs via Telegram/Whats应用/etc. 升级 Prompt

When a Free user attempts a Pro action, 响应:

⚠️ Creating 事件 requires gcal-pro Pro ($12 one-time).

Pro includes: 创建, edit, 删除 事件 + morning briefs.

👉 升级: [gumroad-link]

For now, I can show you your schedule (free) — want to see today's 事件?