← Back to Skills Marketplace
Google Calendar
by
Adrian Miller
· GitHub ↗
· v0.1.0
17080
Downloads
11
Stars
119
Active Installs
1
Versions
Install in OpenClaw
/install google-calendar
Description
Interact with Google Calendar via the Google Calendar API – list upcoming events, create new events, update or delete them. Use this skill when you need programmatic access to your calendar from OpenClaw.
Usage Guidance
Review before installing. Use the narrowest Google Calendar OAuth scope and a limited calendar when possible, confirm event IDs yourself before update or delete operations, and avoid running the refresh helper in shared environments or logs because it writes and prints a short-lived Google access token.
Capability Analysis
Type: OpenClaw Skill
Name: google-calendar
Version: 0.1.0
The skill is classified as suspicious due to a significant discrepancy between its documentation and implementation. The `scripts/refresh_token.py` script writes the obtained `GOOGLE_ACCESS_TOKEN` to a local file (`~/.config/google-calendar/secrets.env`), which is a risky capability (file system write) and is not explicitly mentioned or explained in the `SKILL.md` documentation. Furthermore, the `SKILL.md` describes a different method for obtaining the initial refresh token and a different implementation approach (using the official Google API client library) than what is actually provided in the Python scripts, leading to a lack of transparency and potential operational confusion.
Capability Assessment
Purpose & Capability
The stated purpose matches the main capability: listing, adding, updating, and deleting Google Calendar events through Google APIs. No unrelated exfiltration, obfuscation, or destructive non-calendar behavior was found.
Instruction Scope
Calendar mutation and deletion are documented, but the delete path executes directly with only an event ID and no confirmation, preview, dry-run, or recovery guidance.
Install Mechanism
Setup is user-directed, but the documentation references a helper module and Google client libraries that do not match the bundled urllib-based scripts; dependencies are also unpinned.
Credentials
The skill requires Google OAuth/client credentials and a bearer access token, while the package metadata does not declare those credential requirements; the documentation also describes refresh-token use while the runtime script requires GOOGLE_ACCESS_TOKEN.
Persistence & Privilege
The refresh helper writes GOOGLE_ACCESS_TOKEN to ~/.config/google-calendar/secrets.env and prints the OAuth token response, but SKILL.md tells users to store secrets with openclaw secret set and does not disclose this plaintext local token persistence.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install google-calendar - After installation, invoke the skill by name or use
/google-calendar - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of the Google Calendar skill.
- Supports listing, creating, updating, and deleting events via the Google Calendar API.
- Command-line interface for all operations, with JSON output and error handling.
- Requires OAuth setup (client ID, secret, refresh token) and environment variable configuration.
- Setup and usage documented, including package dependencies and credential management.
Metadata
Frequently Asked Questions
What is Google Calendar?
Interact with Google Calendar via the Google Calendar API – list upcoming events, create new events, update or delete them. Use this skill when you need programmatic access to your calendar from OpenClaw. It is an AI Agent Skill for Claude Code / OpenClaw, with 17080 downloads so far.
How do I install Google Calendar?
Run "/install google-calendar" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Google Calendar free?
Yes, Google Calendar is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Google Calendar support?
Google Calendar is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Google Calendar?
It is built and maintained by Adrian Miller (@adrianmiller99); the current version is v0.1.0.
More Skills