Google Calendar 命令行工具：轻量级集成与自动化管理，支持 OAuth 身份验证

google-calendar by sanjay3290/ai-skills

131 周安装量

192 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/sanjay3290/ai-skills --skill google-calendar

办公软件自动化命令行工具

🇨🇳中文介绍

Google Calendar

轻量级 Google Calendar 集成，具备独立的 OAuth 身份验证。无需 MCP 服务器。

⚠️ 需要 Google Workspace 账户。 不支持个人 Gmail 账户。

首次设置

使用 Google 进行身份验证（会打开浏览器）：

python scripts/auth.py login

检查身份验证状态：

python scripts/auth.py status

需要时登出：

python scripts/auth.py logout

命令

所有操作均通过 scripts/gcal.py 进行。如果首次使用时未登录，将自动进行身份验证。

列出日历

python scripts/gcal.py list-calendars

列出事件

# 列出主日历的事件（默认：未来30天）
python scripts/gcal.py list-events

# 列出指定时间范围内的事件
python scripts/gcal.py list-events --time-min 2024-01-15T00:00:00Z --time-max 2024-01-31T23:59:59Z

# 列出特定日历的事件
python scripts/gcal.py list-events --calendar "work@example.com"

# 限制结果数量
python scripts/gcal.py list-events --max-results 10

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

FlyClaw：零登录航班聚合查询工具，Python实现多源航班信息与价格搜索

4,000,000 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

131,500 周安装

GitHub Actions 官方文档查询助手 - 精准解答 CI/CD 工作流问题

43,400 周安装

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

43,100 周安装

python scripts/gcal.py get-event EVENT_ID
python scripts/gcal.py get-event EVENT_ID --calendar "work@example.com"

# 基础事件
python scripts/gcal.py create-event "Team Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z"

# 带描述和地点的事件
python scripts/gcal.py create-event "Team Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z" \
    --description "Weekly sync" --location "Conference Room A"

# 带参与者的事件
python scripts/gcal.py create-event "Team Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z" \
    --attendees user1@example.com user2@example.com

# 在特定日历上创建事件
python scripts/gcal.py create-event "Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z" \
    --calendar "work@example.com"

# 更新事件标题
python scripts/gcal.py update-event EVENT_ID --summary "New Title"

# 更新事件时间
python scripts/gcal.py update-event EVENT_ID --start "2024-01-15T14:00:00Z" --end "2024-01-15T15:00:00Z"

# 更新多个字段
python scripts/gcal.py update-event EVENT_ID \
    --summary "Updated Meeting" --description "New agenda" --location "Room B"

# 更新参与者
python scripts/gcal.py update-event EVENT_ID --attendees user1@example.com user3@example.com

python scripts/gcal.py delete-event EVENT_ID
python scripts/gcal.py delete-event EVENT_ID --calendar "work@example.com"

为指定参与者查找会议的第一个可用时间段：

# 为自己查找30分钟的空闲时段
python scripts/gcal.py find-free-time \
    --attendees me \
    --time-min "2024-01-15T09:00:00Z" \
    --time-max "2024-01-15T17:00:00Z" \
    --duration 30

# 为多个参与者查找60分钟的空闲时段
python scripts/gcal.py find-free-time \
    --attendees me user1@example.com user2@example.com \
    --time-min "2024-01-15T09:00:00Z" \
    --time-max "2024-01-19T17:00:00Z" \
    --duration 60

# 接受邀请
python scripts/gcal.py respond-to-event EVENT_ID accepted

# 拒绝邀请
python scripts/gcal.py respond-to-event EVENT_ID declined

# 标记为暂定
python scripts/gcal.py respond-to-event EVENT_ID tentative

# 响应但不通知组织者
python scripts/gcal.py respond-to-event EVENT_ID accepted --no-notify

所有时间均使用带时区的 ISO 8601 格式：

UTC：2024-01-15T10:30:00Z
带偏移量：2024-01-15T10:30:00-05:00 (EST)

主日历：使用 primary 或省略 --calendar 标志
其他日历：使用 list-calendars 命令返回的日历 ID（通常是电子邮件地址）

令牌使用系统密钥环安全存储：

macOS：Keychain
Windows：Windows Credential Locker
Linux：Secret Service API (GNOME Keyring, KDE Wallet 等)

服务名称：google-calendar-skill-oauth

令牌过期时会使用 Google 的云函数自动刷新。

🇺🇸English

Google Calendar

Lightweight Google Calendar integration with standalone OAuth authentication. No MCP server required.

⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.

First-Time Setup

Authenticate with Google (opens browser):

python scripts/auth.py login

Check authentication status:

python scripts/auth.py status

Logout when needed:

python scripts/auth.py logout

Commands

All operations via scripts/gcal.py. Auto-authenticates on first use if not logged in.

List Calendars

python scripts/gcal.py list-calendars

List Events

# List events from primary calendar (default: next 30 days)
python scripts/gcal.py list-events

# List events with specific time range
python scripts/gcal.py list-events --time-min 2024-01-15T00:00:00Z --time-max 2024-01-31T23:59:59Z

# List events from a specific calendar
python scripts/gcal.py list-events --calendar "work@example.com"

# Limit results
python scripts/gcal.py list-events --max-results 10

Get Event Details

python scripts/gcal.py get-event EVENT_ID
python scripts/gcal.py get-event EVENT_ID --calendar "work@example.com"

Create Event

# Basic event
python scripts/gcal.py create-event "Team Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z"

# Event with description and location
python scripts/gcal.py create-event "Team Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z" \
    --description "Weekly sync" --location "Conference Room A"

# Event with attendees
python scripts/gcal.py create-event "Team Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z" \
    --attendees user1@example.com user2@example.com

# Event on specific calendar
python scripts/gcal.py create-event "Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z" \
    --calendar "work@example.com"

Update Event

# Update event title
python scripts/gcal.py update-event EVENT_ID --summary "New Title"

# Update event time
python scripts/gcal.py update-event EVENT_ID --start "2024-01-15T14:00:00Z" --end "2024-01-15T15:00:00Z"

# Update multiple fields
python scripts/gcal.py update-event EVENT_ID \
    --summary "Updated Meeting" --description "New agenda" --location "Room B"

# Update attendees
python scripts/gcal.py update-event EVENT_ID --attendees user1@example.com user3@example.com

Delete Event

python scripts/gcal.py delete-event EVENT_ID
python scripts/gcal.py delete-event EVENT_ID --calendar "work@example.com"

Find Free Time

Find the first available slot for a meeting with specified attendees:

# Find 30-minute slot for yourself
python scripts/gcal.py find-free-time \
    --attendees me \
    --time-min "2024-01-15T09:00:00Z" \
    --time-max "2024-01-15T17:00:00Z" \
    --duration 30

# Find 60-minute slot with multiple attendees
python scripts/gcal.py find-free-time \
    --attendees me user1@example.com user2@example.com \
    --time-min "2024-01-15T09:00:00Z" \
    --time-max "2024-01-19T17:00:00Z" \
    --duration 60

Respond to Event Invitation

# Accept an invitation
python scripts/gcal.py respond-to-event EVENT_ID accepted

# Decline an invitation
python scripts/gcal.py respond-to-event EVENT_ID declined

# Mark as tentative
python scripts/gcal.py respond-to-event EVENT_ID tentative

# Respond without notifying organizer
python scripts/gcal.py respond-to-event EVENT_ID accepted --no-notify

Date/Time Format

All times use ISO 8601 format with timezone:

UTC: 2024-01-15T10:30:00Z
With offset: 2024-01-15T10:30:00-05:00 (EST)

Calendar ID Format

Primary calendar: Use primary or omit the --calendar flag
Other calendars: Use the calendar ID from list-calendars (usually an email address)

Token Management

Tokens stored securely using the system keyring:

macOS : Keychain
Windows : Windows Credential Locker
Linux : Secret Service API (GNOME Keyring, KDE Wallet, etc.)

Service name: google-calendar-skill-oauth

Tokens are automatically refreshed when expired using Google's cloud function.

Weekly Installs

108

Repository

sanjay3290/ai-skills

GitHub Stars

169

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketWarn SnykFail

Installed on

codex97

gemini-cli96

opencode95

cursor90

github-copilot89

amp83

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

43,100 周安装

Google Calendar 命令行工具：轻量级集成与自动化管理，支持 OAuth 身份验证

🇨🇳中文介绍

Google Calendar

首次设置

命令

列出日历

列出事件

相关 Skills

获取事件详情

创建事件

更新事件

删除事件

查找空闲时间

响应事件邀请

日期/时间格式

日历 ID 格式

令牌管理

🇺🇸English

Google Calendar

First-Time Setup

Commands

List Calendars

List Events

Get Event Details

Create Event

Update Event

Delete Event

Find Free Time

Respond to Event Invitation

Date/Time Format

Calendar ID Format

Token Management

最新 Skills