Google Calendar Integration

Manage your Google Calendar from Telegram — check schedule, create events, get daily briefings, and receive proactive reminders.

Available MCP Tools

Try loading these tools via ToolSearch first:

1. mcp__google-calendar__list-events — list upcoming events
2. mcp__google-calendar__create-event — create new events
3. mcp__google-calendar__update-event — modify events
4. mcp__google-calendar__delete-event — remove events
5. mcp__google-calendar__find-free-time — check availability

If tools aren't available, the Google Calendar MCP server may not be connected. Tell the user to run:

GOOGLE_OAUTH_CREDENTIALS="~/.claude/scripts/gcp-oauth.keys.json" npx -y @cocal/google-calendar-mcp auth

Use Cases

Check today's schedule

When user asks "what's on my calendar" or "what do I have today":

1. Call list-events with today's date range
2. Format as a clean summary with times, titles, locations
3. Reply via Telegram

Create an event

When user says "add to calendar" or "schedule X":

1. Parse the natural language for: title, date, time, duration, location
2. If anything is ambiguous (e.g. "next Thursday"), ASK the user to confirm before creating
3. Call create-event with structured data
4. Confirm what was created via Telegram reply

Daily briefing

When user asks for "daily briefing" or "morning summary":

1. List today's events
2. List tomorrow's events
3. Format as a concise briefing
4. Can be combined with the schedule tool to auto-send every morning

Find free time

When user asks "when am I free" or "find a slot":

1. Call find-free-time with the requested date range
2. Show available slots

Date/Time Handling

• Always use ISO 8601 format for API calls
• Detect user's timezone from context or default to Europe/Lisbon
• For relative dates ("tomorrow", "next Monday"), calculate the exact date
• For ambiguous times ("afternoon"), ask for clarification

Proactive Calendar Features

The daemon can use the schedule tool to set up recurring calendar checks:

• Morning briefing: Schedule an "every" job at 86400000ms (24h) that checks and sends today's events
• Meeting reminders: After listing events, create schedule reminders for important ones

Response Format

For event listings:

📅 Today's schedule:

09:00 — Team standup (Google Meet)
12:00 — Lunch with Vika & Artem at Café Utro Tempo
15:00 — Product review (Zoom)
18:00 — Free evening

For event creation:

✅ Added to calendar:
April 3rd, 12:00 — Vika's birthday at Café Utro Tempo