Google Calendar

Available Tools

• •

  list_calendars(): List all user's calendars (primary, shared, subscribed).

• •

  list_events(calendar_id?, max_results?, time_min?, time_max?, query?, show_deleted?): List calendar events.

  • •calendar_id (string, optional, default: "primary"): Calendar ID
  • •max_results (integer, optional, default: 10, max: 100): Maximum events
  • •time_min (string, optional, default: now): Start time in RFC3339 format (e.g., "2024-01-01T00:00:00Z")
  • •time_max (string, optional): End time in RFC3339 format
  • •query (string, optional): Free text search
  • •show_deleted (boolean, optional, default: false): Include deleted events
• •

  get_event(event_id, calendar_id?): Get detailed information about a specific event.

  • •event_id (string, required): Event ID (from list_events)
  • •calendar_id (string, optional, default: "primary")
• •

  create_event(summary, start_time, end_time, calendar_id?, description?, location?, attendees?, timezone?, all_day?, reminder_minutes?): Create a new event.

  • •summary (string, required): Event title
  • •start_time (string, required): RFC3339 format (e.g., "2024-01-15T09:00:00") or date "YYYY-MM-DD" for all-day
  • •end_time (string, required): RFC3339 format or date for all-day
  • •calendar_id (string, optional, default: "primary")
  • •description (string, optional): Event description/notes
  • •location (string, optional): Event location
  • •attendees (string, optional): Comma-separated email addresses
  • •timezone (string, optional, default: "UTC"): Timezone (e.g., "Asia/Seoul", "America/New_York")
  • •all_day (boolean, optional, default: false): Create all-day event (use YYYY-MM-DD for times)
  • •reminder_minutes (string, optional): Comma-separated reminder times in minutes (e.g., "10,30,60")
• •

  update_event(event_id, calendar_id?, summary?, start_time?, end_time?, description?, location?, attendees?, timezone?): Update an existing event. Only specified fields are changed.

  • •event_id (string, required)
  • •calendar_id (string, optional, default: "primary")
  • •Other parameters are optional — only provide fields to change
• •

  delete_event(event_id, calendar_id?, send_notifications?): Delete an event.

  • •event_id (string, required)
  • •calendar_id (string, optional, default: "primary")
  • •send_notifications (boolean, optional, default: false): Send cancellation to attendees
• •

  quick_add_event(text, calendar_id?): Create event from natural language text.

  • •text (string, required): Natural language description (e.g., "Meeting with John tomorrow at 3pm", "Team standup every Monday at 9am")
  • •calendar_id (string, optional, default: "primary")
• •

  check_availability(time_min, time_max, calendars?, timezone?): Check free/busy status.

  • •time_min (string, required): Start of range in RFC3339 format
  • •time_max (string, required): End of range in RFC3339 format
  • •calendars (string, optional): Comma-separated calendar IDs (default: primary)
  • •timezone (string, optional, default: "UTC")

Usage Guidelines

• •Time format: RFC3339 — 2024-01-15T09:00:00Z (UTC) or 2024-01-15T09:00:00+09:00 (with timezone).
• •All-day events: use date format YYYY-MM-DD with all_day=true.
• •Default calendar is "primary".

Common Operations

Schedule a meeting: Use create_event with attendees parameter for full control over time, description, and reminders.

Find available time: Call check_availability with the relevant calendar IDs and time range before creating events to avoid conflicts.

Quick scheduling: quick_add_event accepts natural language (e.g., "Lunch with Sarah tomorrow at noon"). Convenient but less precise than create_event.

Reschedule: Use update_event with new start_time and end_time. Only the fields you provide will be changed.