workspace-mcp 1.0.1__py3-none-any.whl → 1.0.2__py3-none-any.whl

gcalendar/calendar_tools.py

@@ -7,14 +7,14 @@ This module provides MCP tools for interacting with Google Calendar API.
 import datetime
 import logging
 import asyncio
-import os
-import sys
+import re
 from typing import List, Optional, Dict, Any
 
 from mcp import types
 from googleapiclient.errors import HttpError
 
 from auth.service_decorator import require_google_service
+from core.utils import handle_http_errors
 
 from core.server import server
 
@@ -30,7 +30,6 @@ def _correct_time_format_for_api(
     if not time_str:
         return None
 
-    # Log the incoming time string for debugging
     logger.info(
         f"_correct_time_format_for_api: Processing {param_name} with value '{time_str}'"
     )
@@ -81,6 +80,7 @@ def _correct_time_format_for_api(
 
 @server.tool()
 @require_google_service("calendar", "calendar_read")
+@handle_http_errors("list_calendars")
 async def list_calendars(service, user_google_email: str) -> str:
     """
     Retrieves a list of calendars accessible to the authenticated user.
@@ -93,36 +93,28 @@ async def list_calendars(service, user_google_email: str) -> str:
     """
     logger.info(f"[list_calendars] Invoked. Email: '{user_google_email}'")
 
-    try:
-        calendar_list_response = await asyncio.to_thread(
-            service.calendarList().list().execute
-        )
-        items = calendar_list_response.get("items", [])
-        if not items:
-            return f"No calendars found for {user_google_email}."
-
-        calendars_summary_list = [
-            f"- \"{cal.get('summary', 'No Summary')}\"{' (Primary)' if cal.get('primary') else ''} (ID: {cal['id']})"
-            for cal in items
-        ]
-        text_output = (
-            f"Successfully listed {len(items)} calendars for {user_google_email}:\n"
-            + "\n".join(calendars_summary_list)
-        )
-        logger.info(f"Successfully listed {len(items)} calendars for {user_google_email}.")
-        return text_output
-    except HttpError as error:
-        message = f"API error listing calendars: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with user's email and service_name='Google Calendar'."
-        logger.error(message, exc_info=True)
-        raise Exception(message)
-    except Exception as e:
-        message = f"Unexpected error listing calendars: {e}."
-        logger.exception(message)
-        raise Exception(message)
+    calendar_list_response = await asyncio.to_thread(
+        lambda: service.calendarList().list().execute()
+    )
+    items = calendar_list_response.get("items", [])
+    if not items:
+        return f"No calendars found for {user_google_email}."
+
+    calendars_summary_list = [
+        f"- \"{cal.get('summary', 'No Summary')}\"{' (Primary)' if cal.get('primary') else ''} (ID: {cal['id']})"
+        for cal in items
+    ]
+    text_output = (
+        f"Successfully listed {len(items)} calendars for {user_google_email}:\n"
+        + "\n".join(calendars_summary_list)
+    )
+    logger.info(f"Successfully listed {len(items)} calendars for {user_google_email}.")
+    return text_output
 
 
 @server.tool()
 @require_google_service("calendar", "calendar_read")
+@handle_http_errors("get_events")
 async def get_events(
     service,
     user_google_email: str,
@@ -142,83 +134,75 @@ async def get_events(
         max_results (int): The maximum number of events to return. Defaults to 25.
 
     Returns:
-        str: A formatted list of events (summary, start time, link) within the specified range.
+        str: A formatted list of events (summary, start and end times, link) within the specified range.
     """
-    try:
+    logger.info(
+        f"[get_events] Raw time parameters - time_min: '{time_min}', time_max: '{time_max}'"
+    )
+
+    # Ensure time_min and time_max are correctly formatted for the API
+    formatted_time_min = _correct_time_format_for_api(time_min, "time_min")
+    effective_time_min = formatted_time_min or (
+        datetime.datetime.utcnow().isoformat() + "Z"
+    )
+    if time_min is None:
         logger.info(
-            f"[get_events] Raw time parameters - time_min: '{time_min}', time_max: '{time_max}'"
+            f"time_min not provided, defaulting to current UTC time: {effective_time_min}"
         )
-
-        # Ensure time_min and time_max are correctly formatted for the API
-        formatted_time_min = _correct_time_format_for_api(time_min, "time_min")
-        effective_time_min = formatted_time_min or (
-            datetime.datetime.utcnow().isoformat() + "Z"
+    else:
+        logger.info(
+            f"time_min processing: original='{time_min}', formatted='{formatted_time_min}', effective='{effective_time_min}'"
         )
-        if time_min is None:
-            logger.info(
-                f"time_min not provided, defaulting to current UTC time: {effective_time_min}"
-            )
-        else:
-            logger.info(
-                f"time_min processing: original='{time_min}', formatted='{formatted_time_min}', effective='{effective_time_min}'"
-            )
-
-        effective_time_max = _correct_time_format_for_api(time_max, "time_max")
-        if time_max:
-            logger.info(
-                f"time_max processing: original='{time_max}', formatted='{effective_time_max}'"
-            )
 
-        # Log the final API call parameters
+    effective_time_max = _correct_time_format_for_api(time_max, "time_max")
+    if time_max:
         logger.info(
-            f"[get_events] Final API parameters - calendarId: '{calendar_id}', timeMin: '{effective_time_min}', timeMax: '{effective_time_max}', maxResults: {max_results}"
+            f"time_max processing: original='{time_max}', formatted='{effective_time_max}'"
         )
 
-        events_result = await asyncio.to_thread(
-            service.events()
-            .list(
-                calendarId=calendar_id,
-                timeMin=effective_time_min,
-                timeMax=effective_time_max,
-                maxResults=max_results,
-                singleEvents=True,
-                orderBy="startTime",
-            )
-            .execute
-        )
-        items = events_result.get("items", [])
-        if not items:
-            return f"No events found in calendar '{calendar_id}' for {user_google_email} for the specified time range."
-
-        event_details_list = []
-        for item in items:
-            summary = item.get("summary", "No Title")
-            start = item["start"].get("dateTime", item["start"].get("date"))
-            link = item.get("htmlLink", "No Link")
-            event_id = item.get("id", "No ID")
-            # Include the event ID in the output so users can copy it for modify/delete operations
-            event_details_list.append(
-                f'- "{summary}" (Starts: {start}) ID: {event_id} | Link: {link}'
-            )
+    logger.info(
+        f"[get_events] Final API parameters - calendarId: '{calendar_id}', timeMin: '{effective_time_min}', timeMax: '{effective_time_max}', maxResults: {max_results}"
+    )
 
-        text_output = (
-            f"Successfully retrieved {len(items)} events from calendar '{calendar_id}' for {user_google_email}:\n"
-            + "\n".join(event_details_list)
+    events_result = await asyncio.to_thread(
+        lambda: service.events()
+        .list(
+            calendarId=calendar_id,
+            timeMin=effective_time_min,
+            timeMax=effective_time_max,
+            maxResults=max_results,
+            singleEvents=True,
+            orderBy="startTime",
         )
-        logger.info(f"Successfully retrieved {len(items)} events for {user_google_email}.")
-        return text_output
-    except HttpError as error:
-        message = f"API error getting events: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with user's email and service_name='Google Calendar'."
-        logger.error(message, exc_info=True)
-        raise Exception(message)
-    except Exception as e:
-        message = f"Unexpected error getting events: {e}"
-        logger.exception(message)
-        raise Exception(message)
+        .execute()
+    )
+    items = events_result.get("items", [])
+    if not items:
+        return f"No events found in calendar '{calendar_id}' for {user_google_email} for the specified time range."
+
+    event_details_list = []
+    for item in items:
+        summary = item.get("summary", "No Title")
+        start_time = item["start"].get("dateTime", item["start"].get("date"))
+        end_time = item["end"].get("dateTime", item["end"].get("date"))
+        link = item.get("htmlLink", "No Link")
+        event_id = item.get("id", "No ID")
+        # Include the start/end date, and event ID in the output so users can copy it for modify/delete operations
+        event_details_list.append(
+            f'- "{summary}" (Starts: {start_time}, Ends: {end_time}) ID: {event_id} | Link: {link}'
+        )
+
+    text_output = (
+        f"Successfully retrieved {len(items)} events from calendar '{calendar_id}' for {user_google_email}:\n"
+        + "\n".join(event_details_list)
+    )
+    logger.info(f"Successfully retrieved {len(items)} events for {user_google_email}.")
+    return text_output
 
 
 @server.tool()
 @require_google_service("calendar", "calendar_events")
+@handle_http_errors("create_event")
 async def create_event(
     service,
     user_google_email: str,
@@ -230,6 +214,7 @@ async def create_event(
     location: Optional[str] = None,
     attendees: Optional[List[str]] = None,
     timezone: Optional[str] = None,
+    attachments: Optional[List[str]] = None,
 ) -> str:
     """
     Creates a new event.
@@ -244,6 +229,7 @@ async def create_event(
         location (Optional[str]): Event location.
         attendees (Optional[List[str]]): Attendee email addresses.
         timezone (Optional[str]): Timezone (e.g., "America/New_York").
+        attachments (Optional[List[str]]): List of Google Drive file URLs or IDs to attach to the event.
 
     Returns:
         str: Confirmation message of the successful event creation with event link.
@@ -251,53 +237,97 @@ async def create_event(
     logger.info(
         f"[create_event] Invoked. Email: '{user_google_email}', Summary: {summary}"
     )
-
-    try:
-        event_body: Dict[str, Any] = {
-            "summary": summary,
-            "start": (
-                {"date": start_time}
-                if "T" not in start_time
-                else {"dateTime": start_time}
-            ),
-            "end": (
-                {"date": end_time} if "T" not in end_time else {"dateTime": end_time}
-            ),
-        }
-        if location:
-            event_body["location"] = location
-        if description:
-            event_body["description"] = description
-        if timezone:
-            if "dateTime" in event_body["start"]:
-                event_body["start"]["timeZone"] = timezone
-            if "dateTime" in event_body["end"]:
-                event_body["end"]["timeZone"] = timezone
-        if attendees:
-            event_body["attendees"] = [{"email": email} for email in attendees]
-
+    logger.info(f"[create_event] Incoming attachments param: {attachments}")
+    # If attachments value is a string, split by comma and strip whitespace
+    if attachments and isinstance(attachments, str):
+        attachments = [a.strip() for a in attachments.split(',') if a.strip()]
+        logger.info(f"[create_event] Parsed attachments list from string: {attachments}")
+    event_body: Dict[str, Any] = {
+        "summary": summary,
+        "start": (
+            {"date": start_time}
+            if "T" not in start_time
+            else {"dateTime": start_time}
+        ),
+        "end": (
+            {"date": end_time} if "T" not in end_time else {"dateTime": end_time}
+        ),
+    }
+    if location:
+        event_body["location"] = location
+    if description:
+        event_body["description"] = description
+    if timezone:
+        if "dateTime" in event_body["start"]:
+            event_body["start"]["timeZone"] = timezone
+        if "dateTime" in event_body["end"]:
+            event_body["end"]["timeZone"] = timezone
+    if attendees:
+        event_body["attendees"] = [{"email": email} for email in attendees]
+
+    if attachments:
+        # Accept both file URLs and file IDs. If a URL, extract the fileId.
+        event_body["attachments"] = []
+        from googleapiclient.discovery import build
+        drive_service = None
+        try:
+            drive_service = service._http and build("drive", "v3", http=service._http)
+        except Exception as e:
+            logger.warning(f"Could not build Drive service for MIME type lookup: {e}")
+        for att in attachments:
+            file_id = None
+            if att.startswith("https://"):
+                # Match /d/<id>, /file/d/<id>, ?id=<id>
+                match = re.search(r"(?:/d/|/file/d/|id=)([\w-]+)", att)
+                file_id = match.group(1) if match else None
+                logger.info(f"[create_event] Extracted file_id '{file_id}' from attachment URL '{att}'")
+            else:
+                file_id = att
+                logger.info(f"[create_event] Using direct file_id '{file_id}' for attachment")
+            if file_id:
+                file_url = f"https://drive.google.com/open?id={file_id}"
+                mime_type = "application/vnd.google-apps.drive-sdk"
+                title = "Drive Attachment"
+                # Try to get the actual MIME type and filename from Drive
+                if drive_service:
+                    try:
+                        file_metadata = await asyncio.to_thread(
+                            lambda: drive_service.files().get(fileId=file_id, fields="mimeType,name").execute()
+                        )
+                        mime_type = file_metadata.get("mimeType", mime_type)
+                        filename = file_metadata.get("name")
+                        if filename:
+                            title = filename
+                            logger.info(f"[create_event] Using filename '{filename}' as attachment title")
+                        else:
+                            logger.info(f"[create_event] No filename found, using generic title")
+                    except Exception as e:
+                        logger.warning(f"Could not fetch metadata for file {file_id}: {e}")
+                event_body["attachments"].append({
+                    "fileUrl": file_url,
+                    "title": title,
+                    "mimeType": mime_type,
+                })
         created_event = await asyncio.to_thread(
-            service.events().insert(calendarId=calendar_id, body=event_body).execute
+            lambda: service.events().insert(
+                calendarId=calendar_id, body=event_body, supportsAttachments=True
+            ).execute()
         )
-
-        link = created_event.get("htmlLink", "No link available")
-        confirmation_message = f"Successfully created event '{created_event.get('summary', summary)}' for {user_google_email}. Link: {link}"
-        logger.info(
+    else:
+        created_event = await asyncio.to_thread(
+            lambda: service.events().insert(calendarId=calendar_id, body=event_body).execute()
+        )
+    link = created_event.get("htmlLink", "No link available")
+    confirmation_message = f"Successfully created event '{created_event.get('summary', summary)}' for {user_google_email}. Link: {link}"
+    logger.info(
             f"Event created successfully for {user_google_email}. ID: {created_event.get('id')}, Link: {link}"
         )
-        return confirmation_message
-    except HttpError as error:
-        message = f"API error creating event: {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Calendar'."
-        logger.error(message, exc_info=True)
-        raise Exception(message)
-    except Exception as e:
-        message = f"Unexpected error creating event: {e}."
-        logger.exception(message)
-        raise Exception(message)
+    return confirmation_message
 
 
 @server.tool()
 @require_google_service("calendar", "calendar_events")
+@handle_http_errors("modify_event")
 async def modify_event(
     service,
     user_google_email: str,
@@ -333,104 +363,91 @@ async def modify_event(
         f"[modify_event] Invoked. Email: '{user_google_email}', Event ID: {event_id}"
     )
 
-    try:
-        # Build the event body with only the fields that are provided
-        event_body: Dict[str, Any] = {}
-        if summary is not None:
-            event_body["summary"] = summary
-        if start_time is not None:
-            event_body["start"] = (
-                {"date": start_time}
-                if "T" not in start_time
-                else {"dateTime": start_time}
-            )
-            if timezone is not None and "dateTime" in event_body["start"]:
-                event_body["start"]["timeZone"] = timezone
-        if end_time is not None:
-            event_body["end"] = (
-                {"date": end_time} if "T" not in end_time else {"dateTime": end_time}
-            )
-            if timezone is not None and "dateTime" in event_body["end"]:
-                event_body["end"]["timeZone"] = timezone
-        if description is not None:
-            event_body["description"] = description
-        if location is not None:
-            event_body["location"] = location
-        if attendees is not None:
-            event_body["attendees"] = [{"email": email} for email in attendees]
-        if (
-            timezone is not None
-            and "start" not in event_body
-            and "end" not in event_body
-        ):
-            # If timezone is provided but start/end times are not, we need to fetch the existing event
-            # to apply the timezone correctly. This is a simplification; a full implementation
-            # might handle this more robustly or require start/end with timezone.
-            # For now, we'll log a warning and skip applying timezone if start/end are missing.
-            logger.warning(
-                f"[modify_event] Timezone provided but start_time and end_time are missing. Timezone will not be applied unless start/end times are also provided."
-            )
+    # Build the event body with only the fields that are provided
+    event_body: Dict[str, Any] = {}
+    if summary is not None:
+        event_body["summary"] = summary
+    if start_time is not None:
+        event_body["start"] = (
+            {"date": start_time}
+            if "T" not in start_time
+            else {"dateTime": start_time}
+        )
+        if timezone is not None and "dateTime" in event_body["start"]:
+            event_body["start"]["timeZone"] = timezone
+    if end_time is not None:
+        event_body["end"] = (
+            {"date": end_time} if "T" not in end_time else {"dateTime": end_time}
+        )
+        if timezone is not None and "dateTime" in event_body["end"]:
+            event_body["end"]["timeZone"] = timezone
+    if description is not None:
+        event_body["description"] = description
+    if location is not None:
+        event_body["location"] = location
+    if attendees is not None:
+        event_body["attendees"] = [{"email": email} for email in attendees]
+    if (
+        timezone is not None
+        and "start" not in event_body
+        and "end" not in event_body
+    ):
+        # If timezone is provided but start/end times are not, we need to fetch the existing event
+        # to apply the timezone correctly. This is a simplification; a full implementation
+        # might handle this more robustly or require start/end with timezone.
+        # For now, we'll log a warning and skip applying timezone if start/end are missing.
+        logger.warning(
+            f"[modify_event] Timezone provided but start_time and end_time are missing. Timezone will not be applied unless start/end times are also provided."
+        )
 
-        if not event_body:
-            message = "No fields provided to modify the event."
-            logger.warning(f"[modify_event] {message}")
-            raise Exception(message)
+    if not event_body:
+        message = "No fields provided to modify the event."
+        logger.warning(f"[modify_event] {message}")
+        raise Exception(message)
 
-        # Log the event ID for debugging
-        logger.info(
-            f"[modify_event] Attempting to update event with ID: '{event_id}' in calendar '{calendar_id}'"
-        )
+    # Log the event ID for debugging
+    logger.info(
+        f"[modify_event] Attempting to update event with ID: '{event_id}' in calendar '{calendar_id}'"
+    )
 
-        # Try to get the event first to verify it exists
-        try:
-            await asyncio.to_thread(
-                service.events().get(calendarId=calendar_id, eventId=event_id).execute
-            )
-            logger.info(
-                f"[modify_event] Successfully verified event exists before update"
-            )
-        except HttpError as get_error:
-            if get_error.resp.status == 404:
-                logger.error(
-                    f"[modify_event] Event not found during pre-update verification: {get_error}"
-                )
-                message = f"Event not found during verification. The event with ID '{event_id}' could not be found in calendar '{calendar_id}'. This may be due to incorrect ID format or the event no longer exists."
-                raise Exception(message)
-            else:
-                logger.warning(
-                    f"[modify_event] Error during pre-update verification, but proceeding with update: {get_error}"
-                )
-
-        # Proceed with the update
-        updated_event = await asyncio.to_thread(
-            service.events()
-            .update(calendarId=calendar_id, eventId=event_id, body=event_body)
-            .execute
+    # Try to get the event first to verify it exists
+    try:
+        await asyncio.to_thread(
+            lambda: service.events().get(calendarId=calendar_id, eventId=event_id).execute()
         )
-
-        link = updated_event.get("htmlLink", "No link available")
-        confirmation_message = f"Successfully modified event '{updated_event.get('summary', summary)}' (ID: {event_id}) for {user_google_email}. Link: {link}"
         logger.info(
-            f"Event modified successfully for {user_google_email}. ID: {updated_event.get('id')}, Link: {link}"
+            f"[modify_event] Successfully verified event exists before update"
         )
-        return confirmation_message
-    except HttpError as error:
-        # Check for 404 Not Found error specifically
-        if error.resp.status == 404:
-            message = f"Event not found. The event with ID '{event_id}' could not be found in calendar '{calendar_id}'. LLM: The event may have been deleted, or the event ID might be incorrect. Verify the event exists using 'get_events' before attempting to modify it."
-            logger.error(f"[modify_event] {message}")
+    except HttpError as get_error:
+        if get_error.resp.status == 404:
+            logger.error(
+                f"[modify_event] Event not found during pre-update verification: {get_error}"
+            )
+            message = f"Event not found during verification. The event with ID '{event_id}' could not be found in calendar '{calendar_id}'. This may be due to incorrect ID format or the event no longer exists."
+            raise Exception(message)
         else:
-            message = f"API error modifying event (ID: {event_id}): {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Calendar'."
-            logger.error(message, exc_info=True)
-        raise Exception(message)
-    except Exception as e:
-        message = f"Unexpected error modifying event (ID: {event_id}): {e}."
-        logger.exception(message)
-        raise Exception(message)
+            logger.warning(
+                f"[modify_event] Error during pre-update verification, but proceeding with update: {get_error}"
+            )
+
+    # Proceed with the update
+    updated_event = await asyncio.to_thread(
+        lambda: service.events()
+        .update(calendarId=calendar_id, eventId=event_id, body=event_body)
+        .execute()
+    )
+
+    link = updated_event.get("htmlLink", "No link available")
+    confirmation_message = f"Successfully modified event '{updated_event.get('summary', summary)}' (ID: {event_id}) for {user_google_email}. Link: {link}"
+    logger.info(
+        f"Event modified successfully for {user_google_email}. ID: {updated_event.get('id')}, Link: {link}"
+    )
+    return confirmation_message
 
 
 @server.tool()
 @require_google_service("calendar", "calendar_events")
+@handle_http_errors("delete_event")
 async def delete_event(service, user_google_email: str, event_id: str, calendar_id: str = "primary") -> str:
     """
     Deletes an existing event.
@@ -447,50 +464,83 @@ async def delete_event(service, user_google_email: str, event_id: str, calendar_
         f"[delete_event] Invoked. Email: '{user_google_email}', Event ID: {event_id}"
     )
 
+    # Log the event ID for debugging
+    logger.info(
+        f"[delete_event] Attempting to delete event with ID: '{event_id}' in calendar '{calendar_id}'"
+    )
+
+    # Try to get the event first to verify it exists
     try:
-        # Log the event ID for debugging
+        await asyncio.to_thread(
+            lambda: service.events().get(calendarId=calendar_id, eventId=event_id).execute()
+        )
         logger.info(
-            f"[delete_event] Attempting to delete event with ID: '{event_id}' in calendar '{calendar_id}'"
+            f"[delete_event] Successfully verified event exists before deletion"
         )
-
-        # Try to get the event first to verify it exists
-        try:
-            await asyncio.to_thread(
-                service.events().get(calendarId=calendar_id, eventId=event_id).execute
+    except HttpError as get_error:
+        if get_error.resp.status == 404:
+            logger.error(
+                f"[delete_event] Event not found during pre-delete verification: {get_error}"
             )
-            logger.info(
-                f"[delete_event] Successfully verified event exists before deletion"
+            message = f"Event not found during verification. The event with ID '{event_id}' could not be found in calendar '{calendar_id}'. This may be due to incorrect ID format or the event no longer exists."
+            raise Exception(message)
+        else:
+            logger.warning(
+                f"[delete_event] Error during pre-delete verification, but proceeding with deletion: {get_error}"
             )
-        except HttpError as get_error:
-            if get_error.resp.status == 404:
-                logger.error(
-                    f"[delete_event] Event not found during pre-delete verification: {get_error}"
-                )
-                message = f"Event not found during verification. The event with ID '{event_id}' could not be found in calendar '{calendar_id}'. This may be due to incorrect ID format or the event no longer exists."
-                raise Exception(message)
-            else:
-                logger.warning(
-                    f"[delete_event] Error during pre-delete verification, but proceeding with deletion: {get_error}"
-                )
 
-        # Proceed with the deletion
-        await asyncio.to_thread(
-            service.events().delete(calendarId=calendar_id, eventId=event_id).execute
-        )
+    # Proceed with the deletion
+    await asyncio.to_thread(
+        lambda: service.events().delete(calendarId=calendar_id, eventId=event_id).execute()
+    )
 
-        confirmation_message = f"Successfully deleted event (ID: {event_id}) from calendar '{calendar_id}' for {user_google_email}."
-        logger.info(f"Event deleted successfully for {user_google_email}. ID: {event_id}")
-        return confirmation_message
-    except HttpError as error:
-        # Check for 404 Not Found error specifically
-        if error.resp.status == 404:
-            message = f"Event not found. The event with ID '{event_id}' could not be found in calendar '{calendar_id}'. LLM: The event may have been deleted already, or the event ID might be incorrect."
-            logger.error(f"[delete_event] {message}")
-        else:
-            message = f"API error deleting event (ID: {event_id}): {error}. You might need to re-authenticate. LLM: Try 'start_google_auth' with the user's email ({user_google_email}) and service_name='Google Calendar'."
-            logger.error(message, exc_info=True)
-        raise Exception(message)
-    except Exception as e:
-        message = f"Unexpected error deleting event (ID: {event_id}): {e}."
-        logger.exception(message)
-        raise Exception(message)
+    confirmation_message = f"Successfully deleted event (ID: {event_id}) from calendar '{calendar_id}' for {user_google_email}."
+    logger.info(f"Event deleted successfully for {user_google_email}. ID: {event_id}")
+    return confirmation_message
+
+
+@server.tool()
+@require_google_service("calendar", "calendar_read")
+@handle_http_errors("get_event")
+async def get_event(
+    service,
+    user_google_email: str,
+    event_id: str,
+    calendar_id: str = "primary"
+) -> str:
+    """
+    Retrieves the details of a single event by its ID from a specified Google Calendar.
+
+    Args:
+        user_google_email (str): The user's Google email address. Required.
+        event_id (str): The ID of the event to retrieve. Required.
+        calendar_id (str): The ID of the calendar to query. Defaults to 'primary'.
+
+    Returns:
+        str: A formatted string with the event's details.
+    """
+    logger.info(f"[get_event] Invoked. Email: '{user_google_email}', Event ID: {event_id}")
+    event = await asyncio.to_thread(
+        lambda: service.events().get(calendarId=calendar_id, eventId=event_id).execute()
+    )
+    summary = event.get("summary", "No Title")
+    start = event["start"].get("dateTime", event["start"].get("date"))
+    end = event["end"].get("dateTime", event["end"].get("date"))
+    link = event.get("htmlLink", "No Link")
+    description = event.get("description", "No Description")
+    location = event.get("location", "No Location")
+    attendees = event.get("attendees", [])
+    attendee_emails = ", ".join([a.get("email", "") for a in attendees]) if attendees else "None"
+    event_details = (
+        f'Event Details:\n'
+        f'- Title: {summary}\n'
+        f'- Starts: {start}\n'
+        f'- Ends: {end}\n'
+        f'- Description: {description}\n'
+        f'- Location: {location}\n'
+        f'- Attendees: {attendee_emails}\n'
+        f'- Event ID: {event_id}\n'
+        f'- Link: {link}'
+    )
+    logger.info(f"[get_event] Successfully retrieved event {event_id} for {user_google_email}.")
+    return event_details