list_calendar_events
Retrieve upcoming Google Calendar events to view your schedule and manage appointments within your Obsidian vault.
Instructions
List upcoming Google Calendar events
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days_ahead | No | ||
| max_results | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/obsidian_mcp/calendar.py:297-1156 (handler)The core helper method in CalendarService that queries the Google Calendar API to list events within a time range. Returns list of event dicts from the API. Used by the MCP tool handler. This is the main implementation logic for fetching events." ,
def list_events( self, max_results: int = 10, time_min: datetime | None = None, time_max: datetime | None = None, ) -> list[dict[str, Any]]: """ List upcoming calendar events. Args: max_results: Maximum number of events to return time_min: Start of time range (default: now) time_max: End of time range (default: 7 days from now) Returns: List of event details Raises: CalendarError: If listing fails """ service = self.get_service() if time_min is None: time_min = datetime.now(timezone.utc) if time_max is None: time_max = time_min + timedelta(days=7) try: events_result = ( service.events() .list( calendarId=self.calendar_id, timeMin=time_min.isoformat() + "Z", timeMax=time_max.isoformat() + "Z", maxResults=max_results, singleEvents=True, orderBy="startTime", ) .execute() ) events = events_result.get("items", []) logger.info(f"Retrieved {len(events)} calendar events") return events # type: ignore[no-any-return] except HttpError as e: raise CalendarError(f"Failed to list events: {e}") from e def get_event(self, event_id: str) -> dict[str, Any]: """ Get a specific calendar event. Args: event_id: Event ID Returns: Event details Raises: CalendarError: If retrieval fails """ service = self.get_service() try: event = service.events().get(calendarId=self.calendar_id, eventId=event_id).execute() return event # type: ignore[no-any-return] except HttpError as e: raise CalendarError(f"Failed to get event: {e}") from e