Guide for using the gcallm CLI to add events to Google Calendar with natural language
Add events to Google Calendar using natural language text, files, clipboard, or screenshots. Use this when you need to quickly schedule meetings and appointments without manually opening Google Calendar.
/plugin marketplace add WarrenZhu050413/Warren-Claude-Code-Plugin-Marketplace/plugin install gcal-plugin@warren-claude-code-plugin-marketplaceUse the gcallm CLI to add events to Google Calendar using natural language.
# Direct text input
gcallm "Meeting with Sarah tomorrow at 3pm"
gcallm "Lunch next Tuesday 12-1pm at Cafe Nero"
gcallm add "Team standup Mon-Fri 9:30am"
# Multiple events at once
gcallm "Team standup Mon-Fri 9:30am, Coffee with Alex Thursday 2pm"
# Pipe from file
cat /tmp/gcal/events.txt | gcallm
cat schedule.txt | gcallm
# Echo to stdin
echo "Doctor appointment Friday 10am" | gcallm
# Uses clipboard if no stdin/args provided
gcallm
# Parse latest screenshot on Desktop
gcallm -s "Add events from this screenshot"
# Parse multiple screenshots
gcallm --screenshots 2 "Add from last 2 screenshots"
# General calendar questions
gcallm ask "What's on my calendar today?"
gcallm ask "When is my next meeting?"
gcallm ask "Am I free Thursday afternoon?"
gcallm calendars
Recommended approach for scripts:
# 1. Write event details to a temp file
cat > /tmp/gcal/events.txt << 'EOF'
Meeting with Prof. Smith Monday 2pm
Coffee with Alex Tuesday 10am
Team standup Wed-Fri 9:30am
EOF
# 2. Pipe to gcallm
cat /tmp/gcal/events.txt | gcallm
gcallm understands flexible date/time formats:
# Configure model (default: claude-sonnet-4-20250514)
gcallm config --model claude-sonnet-4-20250514
# Configure custom prompt
gcallm config --prompt "Custom extraction prompt"
# Show current config
gcallm config --show
Config stored at: ~/.config/gcallm/config.json
# Verify setup
gcallm verify
Ensure the Google Calendar MCP is configured in Claude Code:
claude mcp add gcal npx @anthropic/mcp-google-calendar -s local
Re-run setup:
gcallm setup ~/path/to/oauth-keys.json
/gcal:setup - Set up gcallm with OAuth credentials