Google Calendar

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

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

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

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

First-Time Setup

首次设置

Authenticate with Google (opens browser):

bash

python scripts/auth.py login

Check authentication status:

bash

python scripts/auth.py status

Logout when needed:

bash

python scripts/auth.py logout

通过Google进行认证（会打开浏览器）：

bash

python scripts/auth.py login

检查认证状态：

bash

python scripts/auth.py status

需要时登出：

bash

python scripts/auth.py logout

Commands

命令

All operations via

scripts/gcal.py

. Auto-authenticates on first use if not logged in.

所有操作通过

scripts/gcal.py

执行。如果未登录，首次使用时会自动进行认证。

List Calendars

列出日历

bash

python scripts/gcal.py list-calendars

bash

python scripts/gcal.py list-calendars

List Events

列出事件

bash

undefined

bash

undefined

List events from primary calendar (default: next 30 days)

列出主日历中的事件（默认：未来30天）

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

undefined

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

undefined

Get Event Details

获取事件详情

bash

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

bash

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

Create Event

创建事件

bash

undefined

bash

undefined

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"

undefined

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

undefined

Update Event

更新事件

bash

undefined

bash

undefined

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

undefined

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

undefined

Delete Event

删除事件

bash

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

bash

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:

bash

undefined

查找与指定参会者的首个可用会议时段：

bash

undefined

Find 30-minute slot for yourself

为自己查找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

Find 60-minute slot with multiple attendees

为多位参会者查找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

undefined

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

undefined

Respond to Event Invitation

回复事件邀请

bash

undefined

bash

undefined

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

undefined

python scripts/gcal.py respond-to-event EVENT_ID accepted --no-notify

undefined

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)

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

UTC：
```
2024-01-15T10:30:00Z
```
带偏移量：
```
2024-01-15T10:30:00-05:00
```
（美国东部标准时间）

Calendar ID Format

日历ID格式

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

主日历：使用
```
primary
```
或省略
```
--calendar
```
参数
其他日历：使用
```
list-calendars
```
命令返回的日历ID（通常为邮箱地址）

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.

令牌通过系统密钥环安全存储：

macOS：钥匙串（Keychain）
Windows：Windows凭据管理器
Linux：Secret Service API（GNOME Keyring、KDE Wallet等）

服务名称：

google-calendar-skill-oauth

令牌过期时会通过Google云函数自动刷新。

google-calendar

Original

Translation

Google Calendar

Google Calendar

First-Time Setup

首次设置

Commands

命令

List Calendars

列出日历

List Events

列出事件

List events from primary calendar (default: next 30 days)

列出主日历中的事件（默认：未来30天）

List events with specific time range

列出特定时间范围内的事件

List events from a specific calendar

列出特定日历中的事件

Limit results

限制结果数量

Get Event Details

获取事件详情

Create Event

创建事件

Basic event

基础事件

Event with description and location

带描述和地点的事件

Event with attendees

带参会者的事件

Event on specific calendar

特定日历中的事件

Update Event

更新事件

Update event title

更新事件标题

Update event time

更新事件时间

Update multiple fields

更新多个字段

Update attendees

更新参会者

Delete Event

删除事件

Find Free Time

查找空闲时间

Find 30-minute slot for yourself

为自己查找30分钟的时段

Find 60-minute slot with multiple attendees

为多位参会者查找60分钟的时段

Respond to Event Invitation

回复事件邀请

Accept an invitation

接受邀请

Decline an invitation

拒绝邀请

Mark as tentative

标记为暂定

Respond without notifying organizer

回复但不通知组织者

Date/Time Format

日期/时间格式

Calendar ID Format

日历ID格式

Token Management

令牌管理