List all Google Calendars the user has access to.

Returns: str: JSON array of calendars with id, summary, and primary flag.

Fetch Google Calendar events within a date range.

Returns a list of events with their IDs, titles, start/end times, descriptions, and locations. Use the event ID with other tools to update or delete specific events.

Args: params.start_date: Start of the date range (ISO date string). params.end_date: End of the date range (ISO date string). params.calendar_id: Calendar to query (default: primary). params.max_results: Max events to return (default: 50).

Returns: str: JSON array of event dicts.

Create a new Google Calendar event.

When creating work blocks for Notion tasks, include the task's Notion URL in the description so there's a direct link from the calendar event to the task.

Args: params.title: Event title. params.start: ISO datetime string for start time. params.end: ISO datetime string for end time. params.description: Optional description (include Notion task URL here for task blocks). params.location: Optional location. params.calendar_id: Target calendar (default: primary).

Returns: str: JSON dict of the created event including its 'id'.

Update one or more fields on an existing Google Calendar event. Only provided fields are changed; omitted fields remain as-is.

Args: params.event_id: ID of the event to update. params.calendar_id: Calendar containing the event. params.title/start/end/description/location: Fields to update.

Returns: str: JSON dict of the updated event.

Permanently delete a Google Calendar event.

This action cannot be undone. Confirm the event ID with gcal_get_events before deleting.

Args: params.event_id: ID of the event to delete. params.calendar_id: Calendar containing the event.

Returns: str: Confirmation message.

Find available time slots of a given duration on a specific date.

Useful for scheduling work blocks, appointments, or any time-bound task. Returns all slots with at least the requested duration available.

Args: params.date: The date to check (ISO date string). params.duration_minutes: How long the slot needs to be (in minutes). params.earliest_hour: Don't suggest slots starting before this hour. params.latest_hour: Don't suggest slots ending after this hour. params.calendar_id: Calendar to check for conflicts.

Returns: str: JSON array of available slots with 'start' and 'end' ISO datetimes.

Query the Notion Appointments database with optional filters.

Returns appointments with Notion ID, title, start/end times, type, status, notes, and linked Google Calendar event ID (if synced).

Args: params.start_date: Only return appointments from this date onwards. params.end_date: Only return appointments up to this date. params.appointment_type: Filter by Medical, Personal, Work, or Other. params.status: Filter by Scheduled, In progress, or Completed.

Returns: str: JSON array of appointment dicts.

Create a new appointment in the Notion Appointments database.

When syncing from Google Calendar, always pass the gcal_event_id to prevent duplicates. When creating a new appointment from scratch, omit gcal_event_id and use gcal_create_event separately to sync it to Google Calendar.

Args: params.title: Appointment name. params.start/end: ISO datetime strings. params.appointment_type: Medical, Personal, Work, or Other. params.notes: Optional notes. params.gcal_event_id: Google Calendar event ID (if syncing from GCal). params.gcal_series_id: Google Calendar series ID (for recurring appointments). params.recurring: One-Time, Limited Recurring, or Recurring.

Returns: str: JSON dict of the created appointment including Notion ID.

Update fields on an existing Notion appointment. Only provided fields change.

Args: params.notion_id: The Notion page ID (from notion_get_appointments). params.*: Any fields to update.

Returns: str: JSON dict of the updated appointment.

Find a Notion appointment by its linked Google Calendar event ID.

Use this before syncing to check whether a calendar event already has a corresponding Notion record, preventing duplicate entries.

Args: params.gcal_event_id: Google Calendar event ID to search for.

Returns: str: JSON dict of the appointment if found, or a not-found message.

Query the Notion Tasks database with optional filters.

Returns tasks with their Notion IDs, names, statuses, due dates, and Notion URLs (for linking in calendar event descriptions).

Args: params.status: Filter by Not started, In progress, Done, Archived, or Overdue. params.due_before: Only return tasks due on or before this date. params.due_after: Only return tasks due on or after this date.

Returns: str: JSON array of task dicts.

Return all overdue tasks — either explicitly marked Overdue or with a due date in the past that isn't marked Done, Archived, or Overdue.

Returns: str: JSON array of overdue task dicts.

Create a new task in the Notion Tasks database.

Args: params.name: Task name. params.due_date: Optional due date (ISO date string). params.status: Initial status (default: Not started).

Returns: str: JSON dict of the created task including its Notion ID and URL.

Update fields on an existing Notion task. Only provided fields change.

Args: params.notion_id: Notion page ID (from notion_get_tasks). params.name/status/due_date: Fields to update.

Returns: str: JSON dict of the updated task.

Get a unified overview of a week: calendar events, Notion appointments, and tasks due that week.

This is the primary 'how does my week look?' tool. It pulls from all three sources and returns a combined view so you can see everything in context — scheduled appointments, work blocks, and upcoming deadlines.

Args: params.date: Any date in the target week (defaults to current week).

Returns: str: JSON with 'week_range', 'calendar_events', 'appointments', 'tasks_due', and 'overdue_tasks' keys.

Schedule a focused work block for a Notion task on Google Calendar.

Creates a Google Calendar event with the task name as the title and a link to the Notion task in the description. The task itself is NOT modified — this just blocks time and creates a visible pointer.

Typical workflow: 1. notion_get_tasks → find the task and get its ID and URL 2. gcal_find_free_slots → find available time 3. schedule_task_block → create the calendar event with Notion link

Args: params.task_notion_id: Notion page ID of the task. params.task_name: Task name (used as event title). params.task_url: Notion URL (embedded in event description). params.start/end: ISO datetime strings for the work block. params.calendar_id: Target calendar.

Returns: str: JSON with the created calendar event and a confirmation.

Detect overlapping events or tight transitions in a date range.

Checks Google Calendar events for: exact overlaps, events with fewer than 10 minutes between them (tight transitions), and events longer than 4 hours (marathon sessions worth flagging).

Args: params.start_date: Start of the range to scan. params.end_date: End of the range to scan. params.calendar_id: Calendar to check.

Returns: str: JSON with lists of overlaps, tight transitions, and long events.