Set up gcallm CLI with Google Calendar OAuth2 credentials
Guides you through setting up the gcallm CLI to add events to Google Calendar via OAuth2. Use this first to configure credentials and install the required MCP server before using calendar commands.
/plugin marketplace add WarrenZhu050413/Warren-Claude-Code-Plugin-Marketplace/plugin install gcal-plugin@warren-claude-code-plugin-marketplaceThis command guides you through setting up the gcallm CLI for adding events to Google Calendar.
You need:
~/gcp-oauth.keys.json)# Install from PyPI
uv tool install gcallm
# Or with pip
pip install gcallm
Verify installation:
which gcallm
# Should output: ~/.local/bin/gcallm (or similar)
Point gcallm to your OAuth credentials:
gcallm setup ~/gcp-oauth.keys.json
Or interactively:
gcallm setup
# Will prompt for path
gcallm requires the Google Calendar MCP server. Add it to Claude Code:
claude mcp add gcal npx @anthropic/mcp-google-calendar -s local
This uses the OAuth credentials you configured.
gcallm verify
Expected output:
Google Calendar MCP: OK
OAuth credentials: Configured
Test with a simple query:
gcallm ask "What's on my calendar today?"
~/.config/gcallm/
├── config.json # Settings (model, prompt)
└── oauth_path # Path to OAuth credentials
# OAuth credentials (shared with other Google tools)
~/gcp-oauth.keys.json # Or wherever you saved it
The Google Calendar MCP server isn't set up:
# Add the MCP server
claude mcp add gcal npx @anthropic/mcp-google-calendar -s local
# Verify it's configured
claude mcp list
Re-run setup with the correct path:
gcallm setup /correct/path/to/oauth-keys.json
Your OAuth token may have expired. Re-authenticate:
rm ~/.config/gcallm/*gcallm setup ~/gcp-oauth.keys.jsonEnsure the OAuth app has calendar scope:
https://www.googleapis.com/auth/calendar/gcal - Usage guide for gcallm CLI