← Back to Skills Marketplace
195
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install py-googlecalendar-cli
Description
Tiny and short Python CLI tool to manage Google Calendar events from the command line -- list, add, update, delete events via the Calendar API.
README (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
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install py-googlecalendar-cli - After installation, invoke the skill by name or use
/py-googlecalendar-cli - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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. It is an AI Agent Skill for Claude Code / OpenClaw, with 195 downloads so far.
How do I install py-googlecalendar-cli?
Run "/install py-googlecalendar-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is py-googlecalendar-cli free?
Yes, py-googlecalendar-cli is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does py-googlecalendar-cli support?
py-googlecalendar-cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created py-googlecalendar-cli?
It is built and maintained by xwings (@xwings); the current version is v1.0.0.
More Skills