Back to Details

google-calendar

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Calendar Skill

Google Calendar Skill

This skill allows the AI to manage the user's Google Calendar.
该Skill允许AI管理用户的Google Calendar。

Features

功能特性

  • List: See upcoming events to avoid conflicts.
  • Create: Schedule new events (meetings, reminders).
  • 列出：查看即将到来的日程事件，避免时间冲突。
  • 创建：安排新的日程事件（会议、提醒事项）。

Prerequisites

前置条件

  1. Google Cloud Project with Google Calendar API enabled.
  2. OAuth 2.0 Credentials (
    credentials.json
    ) in 
    ~/.calendar_credentials/
    .
  1. 已启用Google Calendar API的Google Cloud Project。
  2. 将OAuth 2.0 Credentials（
    credentials.json
    ）放置在
    ~/.calendar_credentials/
    目录下。

Setup

配置步骤

  1. Recommended (gcloud ADC):
    bash
    gcloud auth application-default login --scopes https://www.googleapis.com/auth/calendar.events,https://www.googleapis.com/auth/cloud-platform
    Then verify:
    bash
    uv run skills/google-calendar/scripts/google_calendar.py verify
  2. Alternative (credentials.json):
    • Place 
      credentials.json
      in 
      ~/.calendar_credentials/
      .
    • Run 
      uv run skills/google-calendar/scripts/google_calendar.py setup
  1. 推荐方式（gcloud ADC）：
    bash
    gcloud auth application-default login --scopes https://www.googleapis.com/auth/calendar.events,https://www.googleapis.com/auth/cloud-platform
    然后验证：
    bash
    uv run skills/google-calendar/scripts/google_calendar.py verify
  2. 替代方式（credentials.json）：
    • 将
      credentials.json
      放置在
      ~/.calendar_credentials/
      目录下。
    • 运行
      uv run skills/google-calendar/scripts/google_calendar.py setup

Usage

使用方法

1. List Upcoming Events

1. 列出即将到来的日程事件

bash
uv run skills/google-calendar/scripts/google_calendar.py list --limit 5
bash
uv run skills/google-calendar/scripts/google_calendar.py list --limit 5

2. Create Event

2. 创建日程事件

bash
undefined
bash
undefined

Schedule a Council Meeting

安排一场绝地委员会会议

uv run skills/google-calendar/scripts/google_calendar.py create
--summary "Jedi Council Meeting"
--start "2026-05-04T10:00:00"
--end "2026-05-04T11:00:00"
--description "Discussing the prophecy."
undefined
uv run skills/google-calendar/scripts/google_calendar.py create
--summary "Jedi Council Meeting"
--start "2026-05-04T10:00:00"
--end "2026-05-04T11:00:00"
--description "Discussing the prophecy."
undefined

JSON Output

JSON输出

json
[
  {
    "summary": "Podrace",
    "start": { "dateTime": "2026-05-04T14:00:00Z" },
    "end": { "dateTime": "2026-05-04T16:00:00Z" }
  }
]
json
[
  {
    "summary": "Podrace",
    "start": { "dateTime": "2026-05-04T14:00:00Z" },
    "end": { "dateTime": "2026-05-04T16:00:00Z" }
  }
]