Google Calendar MCP

Instructions

Implementation Reference

• google_calendar_mcp/server.py:29-45 (handler)

  The handler function for the 'list_day_events' tool, decorated with @mcp.tool(), which fetches events for a specific date from Google Calendar.

  @mcp.tool()
  def list_day_events(date: str) -> dict[str, Any]:
      """지정한 날짜(YYYY-MM-DD)의 모든 일정 목록 조회"""
      service = get_calendar_service()
      start_date = datetime.strptime(date, "%Y-%m-%d")
      end_date = start_date + timedelta(days=1)
      time_min = start_date.isoformat() + 'Z'
      time_max = end_date.isoformat() + 'Z'
      events_result = service.events().list(
          calendarId='primary',
          timeMin=time_min,
          timeMax=time_max,
          singleEvents=True,
          orderBy='startTime'
      ).execute()
      events = events_result.get('items', [])
      return {"count": len(events), "events": events}

• google_calendar_mcp/google_auth.py:15-29 (helper)

  Supporting helper function that handles Google OAuth authentication and returns the Calendar API service instance, imported and used in the handler.

  def get_calendar_service():
      creds = None
      if os.path.exists(TOKEN_FILE):
          with open(TOKEN_FILE, "rb") as token:
              creds = pickle.load(token)
      if not creds or not creds.valid:
          if creds and creds.expired and creds.refresh_token:
              creds.refresh(Request())
          else:
              flow = InstalledAppFlow.from_client_secrets_file(CLIENT_SECRET_FILE, SCOPES)
              creds = flow.run_local_server(port=0)
          with open(TOKEN_FILE, "wb") as token:
              pickle.dump(creds, token)
      service = build("calendar", "v3", credentials=creds)
      return service