Obsidian MCP Server

Instructions

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