← 返回 Skills 市场

py-googlecalendar-cli

Name: py-googlecalendar-cli
Author: xwings

作者 xwings · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

195

总下载

当前安装

版本数

在 OpenClaw 中安装

/install py-googlecalendar-cli

功能描述

Tiny and short Python CLI tool to manage Google Calendar events from the command line -- list, add, update, delete events via the Calendar API.

使用说明 (SKILL.md)

Google Calendar CLI

A single-file CLI for Google Calendar using only Python 3 standard library.

Setup

Create a Google Cloud project and enable the Google Calendar API.
Create OAuth 2.0 credentials (Desktop app). Note the client ID and secret.
Obtain a refresh token via the OAuth consent flow.

Export credentials:

export GOOGLE_CLIENT_ID=...
export GOOGLE_CLIENT_SECRET=...
export GOOGLE_REFRESH_TOKEN=...
export GOOGLE_CALENDAR_ID=primary  # optional, defaults to "primary"

Usage

google-calendar-cli.py \x3Ccommand> [options]

Command	Description
`list`	List upcoming events
`today`	Show today's events
`add`	Create a new event
`update`	Update an existing event
`delete`	Delete an event

Credentials can also be passed as flags (--client-id, --client-secret, --refresh-token, --calendar-id).

Use --json for raw JSON output. Run with -h for full help.

Examples

# List next 10 events
python3 {baseDir}/scripts/google-calendar-cli.py list

# Today's events
python3 {baseDir}/scripts/google-calendar-cli.py today

# Events in a date range
python3 {baseDir}/scripts/google-calendar-cli.py list --from 2025-06-01T00:00:00Z --to 2025-06-30T23:59:59Z

# Add an event
python3 {baseDir}/scripts/google-calendar-cli.py add --title "Meeting" \
    --start 2025-06-01T09:00:00-07:00 --end 2025-06-01T10:00:00-07:00

# Update an event
python3 {baseDir}/scripts/google-calendar-cli.py update --event-id EVENT_ID --title "New Title"

# Delete an event
python3 {baseDir}/scripts/google-calendar-cli.py delete --event-id EVENT_ID

安全使用建议

This looks like a straightforward Google Calendar CLI. Before installing: (1) verify the GitHub source (homepage) and review the script yourself — the package contains the full Python file; (2) only provide OAuth client_id, client_secret, and refresh_token if you trust the code and host — a refresh token grants ongoing access to your calendar and should be protected; (3) consider creating a dedicated OAuth client and consenting only the minimum scopes, and be prepared to revoke the refresh token if anything seems off; (4) run the script locally first (not on a shared agent) to confirm behavior; and (5) note the minor metadata inconsistency (registry said no envs while SKILL.md requires them) — this is likely an authoring oversight rather than malicious behavior.

功能分析

Type: OpenClaw Skill Name: py-googlecalendar-cli Version: 1.0.0 The skill provides a standard CLI for managing Google Calendar events via the official Google Calendar API. It uses OAuth2 refresh tokens for authentication, communicates only with legitimate Google endpoints (googleapis.com), and is implemented using only the Python standard library. No evidence of data exfiltration, malicious execution, or prompt injection was found in scripts/google-calendar-cli.py or SKILL.md.

能力评估

ℹ Purpose & Capability

The name/description match the included Python CLI which calls the Google Calendar API. The tool legitimately requires OAuth client_id, client_secret, and a refresh_token; however the registry-level 'Requirements' block listed no required env vars while SKILL.md metadata and the script clearly require GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN (and optionally GOOGLE_CALENDAR_ID). This metadata mismatch is not dangerous but is an inconsistency to be aware of.

✓ Instruction Scope

SKILL.md only instructs obtaining OAuth credentials, exporting env vars or passing flags, and running the provided Python script. The script only calls Google OAuth and the Google Calendar API endpoints and does not reference other files, system credentials, or unexpected network endpoints.

✓ Install Mechanism

There is no install spec or third-party download; code is provided in the package and uses only the Python standard library. No archive downloads, package manager installs, or external installers are present.

✓ Credentials

The required environment variables (client id, client secret, refresh token, calendar id) are directly necessary for OAuth-based access to Google Calendar. No unrelated secrets or extra credentials are requested.

✓ Persistence & Privilege

The skill is not forced-always, has default autonomous-invocation settings, and does not request system-wide configuration or modify other skills. It does not request elevated or persistent system privileges.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install py-googlecalendar-cli
安装完成后，直接呼叫该 Skill 的名称或使用 /py-googlecalendar-cli 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release of google-calendar: simple Python CLI for Google Calendar event management. - Supports listing, adding, updating, and deleting events directly from the command line. - Uses only the Python 3 standard library; no extra dependencies required. - Credentials can be provided via environment variables or CLI flags. - Offers optional JSON output and full help via the -h flag.

元数据

Slug py-googlecalendar-cli

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题