← Back to Skills Marketplace
11505
Downloads
21
Stars
0
Active Installs
12
Versions
Install in OpenClaw
/install google-calendar-api
Description
Google Calendar API integration with managed OAuth. Create events, list calendars, check availability, and manage schedules. Use this skill when users want to interact with Google Calendar. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user.
Usage Guidance
Install only if you trust Maton to broker Google Calendar access. Prefer OAuth, choose the narrowest Google scopes available, confirm the exact calendar/account before writes, and treat the raw API fallback/API key path as higher risk because it handles a long-lived credential.
Capability Assessment
Credentials
Network access, Bash, and a Maton/Google Calendar account are proportionate for this integration, though calendar contents and scheduling actions can expose personal or business data.
Install Mechanism
Installation is limited to standard Maton CLI package-manager commands, with optional SDK installs; no bundled executable scripts or hidden install behavior were present.
Instruction Scope
The raw `maton api` passthrough is broader than the listed examples, but the artifact discloses that breadth and repeatedly requires read-first behavior plus explicit confirmation for writes and new connections.
Persistence & Privilege
OAuth profiles, stored credentials, and Google Calendar connections persist via the Maton/OS credential store, but this is disclosed with instructions not to inspect secrets and to revoke unused connections.
Purpose & Capability
The documented capabilities are coherent with the stated Google Calendar purpose: list calendars/events, check free/busy, and create, update, or delete events through Maton.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install google-calendar-api - After installation, invoke the skill by name or use
/google-calendar-api - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.1
Address security-audit findings: disclose the api passthrough in the access-scope and description text, warn on irreversible connection deletion, add response data-minimization guidance, and correct app-specific auth and request-body notes
v1.2.0
CLI-first rewrite with the Maton SDK examples; clarify that the CLI and SDKs keep separate credential stores, and reword webhook egress warnings
v1.1.0
CLI-first rewrite: the maton CLI with OAuth login is the documented path, every example is a maton command, SDK examples added, and the raw HTTP fallback feeds the key on stdin instead of reading it from the environment
v1.0.8
- Removed the skill-card.md file from the project.
- No changes to functionality or APIs.
- Documentation and usage remain the same.
v1.0.7
- Added CLI command examples throughout for key workflows, including listing events and managing connections.
- Added installation instructions for NPM and Homebrew.
- Updated authentication and connection management sections with CLI usage alongside API examples.
- Expanded quick start section with practical 'agenda' command examples.
- Added CLI equivalents to API reference endpoints for easier usage.
- Improved clarity and structure of setup and operational instructions.
v1.0.6
- Updated all endpoint URLs from gateway.maton.ai and ctrl.maton.ai to api.maton.ai.
- Clarified connection management instructions and updated related endpoint examples.
- Added a section on security and permissions, emphasizing user approval for write operations.
- Removed the LICENSE.txt file from the repository.
v1.0.5
- Added a new `clawdbot` metadata section with an emoji and required `MATON_API_KEY` environment variable.
- No changes to code, endpoints, or functionality.
v1.0.4
No changes detected in this version.
v1.0.3
- Replaced most curl command examples with Python command-line scripts using `urllib.request` for easier cross-platform usage.
- Updated "Quick Start" and connection management sections to use Python snippets instead of curl.
- Documentation now emphasizes Python as the main method for interacting with the API from the command line.
- No changes to the API or endpoints; all updates are in documentation and examples only.
v1.0.2
- Added a note in the description directing users to use the api-gateway skill for other third party apps.
- Improved curl and environment variable usage instructions, including new notes on using curl -g with bracketed parameters and caveats about environment variable expansion when piping to other commands.
v1.0.1
- Updated the base URL syntax to use `{native-api-path}` for clarity.
- Expanded information and examples for specifying the Google Calendar connection with the `Maton-Connection` header.
- Added new fields to connection response examples, such as `creation_time`, `last_updated_time`, and `metadata`.
- Clarified instructions for obtaining an API key and managing multiple Google Calendar connections.
v1.0.0
Major update: Migrated implementation from local Python scripts to a managed cloud API with OAuth integration.
- Replaced all Python scripts and local environment setup with Maton-hosted endpoints and OAuth flow.
- Added detailed instructions for using the Maton API gateway and managing OAuth connections.
- Updated authentication to use the Maton API key in request headers.
- Provided comprehensive API reference and example code for JS and Python.
- Included error handling guidelines and links to official Google Calendar API resources.
Metadata
Frequently Asked Questions
What is Google Calendar?
Google Calendar API integration with managed OAuth. Create events, list calendars, check availability, and manage schedules. Use this skill when users want to interact with Google Calendar. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Calls run through the `maton` CLI with OAuth login, or over raw HTTP with a Maton API key where the CLI cannot be installed. The endpoints documented here are the intended surface, not a technical limit — the `maton api` passthrough can reach others the connection permits. Default to read and list calls, and confirm every write or new connection with the user. It is an AI Agent Skill for Claude Code / OpenClaw, with 11505 downloads so far.
How do I install Google Calendar?
Run "/install google-calendar-api" 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, licensed under MIT-0. 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 byungkyu (@byungkyu); the current version is v1.2.1.
More Skills