Gmail MCP Server

    List events from the user's Google Calendar.
    
    This tool retrieves a list of upcoming events from the user's calendar.
    
    Prerequisites:
    - The user must be authenticated with Google Calendar access
    
    Args:
        max_results (int, optional): Maximum number of events to return. Defaults to 10.
        time_min (str, optional): Start time for the search in ISO format or natural language.
                                 Defaults to now.
        time_max (str, optional): End time for the search in ISO format or natural language.
                                 Defaults to unlimited.
        query (str, optional): Free text search terms to find events that match.
        
    Returns:
        Dict[str, Any]: The list of events including:
            - events: List of calendar events with details and links
            - next_page_token: Token for pagination (if applicable)
            
    Example usage:
    1. List upcoming events:
       list_calendar_events()
       
    2. List events for a specific time range:
       list_calendar_events(time_min="tomorrow", time_max="tomorrow at 11:59pm")
       
    3. Search for specific events:
       list_calendar_events(query="meeting")
       
    Important:
    - Always include the event_link when discussing specific events with the user
    - The event_link allows users to directly access their events in Google Calendar
    - When listing multiple events, include the event_link for each event