iflow-mcp_rsc1102-google_calendar_mcp 0.1.0__py3-none-any.whl

calendar_mcp.py

@@ -0,0 +1,131 @@
+from mcp.server.fastmcp import FastMCP
+import services
+
+# Initialize FastMCP server
+mcp = FastMCP("calendar")
+
+
+@mcp.tool()
+async def list_events(
+    summary: str | None = None,
+    description: str | None = None,
+    location: str | None = None,
+    timeMin: str | None = None,
+    timeMax: str | None = None,
+    maxResults: int = 10,
+) -> str:
+    """
+    Retrieve a list of calendar events based on specified filters.
+
+    This function queries the calendar for events that match the given criteria.
+    All filter parameters are optional and can be used in combination to narrow
+    down the results.
+
+    Args:
+        summary (str, optional): Filter events by their summary (title or subject).
+        description (str, optional): Filter events by text found in the event description.
+        location (str, optional): Filter events based on their location.
+        timeMin (str, optional): ISO 8601 formatted lower time bound (exclusive)
+            for filtering events by end time. Must be in local time and have timezone offset.
+        timeMax (str, optional): ISO 8601 formatted upper time bound (exclusive)
+            for filtering events by start time. Must be in local time and have timezone offset.
+        maxResults (int, optional): Maximum number of events to return.
+
+    Returns:
+        list: A list of event objects that match the provided filters.
+    """
+    return await services.list_events(
+        summary=summary,
+        description=description,
+        location=location,
+        timeMin=timeMin,
+        timeMax=timeMax,
+        maxResults=maxResults,
+    )
+
+
+@mcp.tool()
+async def create_event(
+    start: str,
+    end: str,
+    timeZone: str,
+    summary: str,
+    description: str | None = None,
+    location: str | None = None,
+) -> str:
+    """
+    Creates a calendar event using the provided details.
+
+    Args:
+        start (str): Event start time in ISO 8601 format (e.g., '2025-04-06T10:00:00-07:00').
+        end (str): Event end time in ISO 8601 format (e.g., '2025-04-06T11:00:00-07:00').
+        timeZone (str): User timezone formatted as an IANA Time Zone Database name (e.g. "Europe/Zurich").
+        summary (str): Short title or subject of the event.
+        description (str, optional): Detailed description or notes for the event. Defaults to None.
+        location (str, optional): Physical or virtual location of the event. Defaults to None.
+    """
+
+    return await services.create_event(
+        start=start,
+        end=end,
+        timeZone=timeZone,
+        summary=summary,
+        description=description,
+        location=location,
+    )
+
+
+@mcp.tool()
+async def delete_event(event_id: str):
+    """
+    Deletes an event from the calender.
+
+    Args:
+        event_id: Event identifier.
+    """
+
+    return await services.delete_event(event_id=event_id)
+
+
+@mcp.tool()
+async def update_event(
+    event_id: str,
+    start: str | None = None,
+    end: str | None = None,
+    timeZone: str | None = None,
+    summary: str | None = None,
+    description: str | None = None,
+    location: str | None = None,
+):
+    """
+    Updates an event by replacing specified fields with new values.
+    Any fields not included in the request will retain their existing values.
+
+    Args:
+        event_id (str): Event identifier.
+        start (str, optional): Event start time in ISO 8601 format (e.g., '2025-04-06T10:00:00-04:00'). Defaults to None.
+        end (str, optional): Event end time in ISO 8601 format (e.g., '2025-04-06T11:00:00-04:00'). Defaults to None.
+        timeZone (str, optional): User timezone formatted as an IANA Time Zone Database name (e.g. "Europe/Zurich"). Defaults to None.
+        summary (str, optional): Short title or subject of the event. Defaults to None.
+        description (str, optional): Detailed description or notes for the event. Defaults to None.
+        location (str, optional): Physical or virtual location of the event. Defaults to None.
+    """
+
+    return await services.update_event(
+        event_id=event_id,
+        start=start,
+        end=end,
+        timeZone=timeZone,
+        summary=summary,
+        description=description,
+        location=location,
+    )
+
+
+if __name__ == "__main__":
+    # Run MCP server
+    mcp.run(transport="stdio")
+
+def main():
+    """Entry point for the package"""
+    mcp.run(transport="stdio")

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_rsc1102-google_calendar_mcp
+Version: 0.1.0
+Summary: An MCP server to interact with Google Calendar
+Requires-Python: >=3.11
+Requires-Dist: google-api-python-client>=2.166.0
+Requires-Dist: google-auth-oauthlib>=1.2.1
+Requires-Dist: google-auth>=2.38.0
+Requires-Dist: mcp[cli]>=1.6.0
+Description-Content-Type: text/markdown
+
+# Google Calendar MCP Server ![Anthropic](https://img.shields.io/badge/Anthropic-ffffff?logo=anthropic&logoColor=black) ![Claude](https://img.shields.io/badge/Claude-ffffff?logo=claude&logoColor=orange)
+
+This repository provides a Model Context Protocol (MCP) server that integrates with the Google Calendar API. It allows users to list, create, delete, and update calendar events. The server is designed to work with Anthropic's Claude Desktop as an MCP client.
+
+## 🚀 Features
+- Interact with Google Calendar: list, add, delete, and update events
+- Seamless integration with Claude Desktop via MCP
+
+---
+
+## 🧰 Prerequisites
+- A Google Account
+- [Anthropic Claude Desktop](https://claude.ai/download)
+
+---
+
+## 📦 Installation
+
+1. **Install UV Package Manager:**
+   Follow the instructions on the [official UV installation guide](https://docs.astral.sh/uv/getting-started/installation/#installation-methods).
+
+2. **Clone the Repository and Set Up Environment:**
+   ```bash
+   git clone https://github.com/rsc1102/Google_Calendar_MCP.git
+   cd Google_Calendar_MCP
+   uv sync
+   ```
+
+3. **Create Google Cloud Credentials:**
+   - Visit [Google Cloud Console](https://console.cloud.google.com/).
+   - Create a new project or select an existing one.
+   - Enable the **Google Calendar API**.
+   - Navigate to **APIs & Services > Credentials**.
+   - Click **Create Credentials > OAuth Client ID**:
+     - Choose **Desktop app** as the application type.
+     - Download the generated `credentials.json` file.
+     - Place `credentials.json` inside the `Google_Calendar_MCP` directory.
+
+---
+
+## 🔌 Integration with Claude Desktop
+
+1. **Locate Configuration File:**
+   Open the `claude_desktop_config.json` file on your system:
+
+   **Linux/macOS:**
+   ```bash
+   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
+   ```
+
+   **Windows (PowerShell):**
+   ```bash
+   code $env:AppData\Claude\claude_desktop_config.json
+   ```
+
+2. **Add MCP Server Configuration:**
+   Add the following to the `mcpServers` section:
+   ```json
+   {
+       "mcpServers": {
+           "calendar": {
+               "command": "uv",
+               "args": [
+                   "--directory",
+                   "/ABSOLUTE/PATH/TO/PARENT/FOLDER/Google_Calendar_MCP",
+                   "run",
+                   "calendar_mcp.py"
+               ]
+           }
+       }
+   }
+   ```
+
+3. **Restart Claude Desktop.**
+
+4. **Create a New Project in Claude Desktop.**
+
+5. **Set Timezone:**
+   In the project's knowledge section, define your local timezone using the IANA Time Zone format (e.g., `timeZone="America/New_York"`).
+
+6. **Start Chatting:**
+   Begin interacting with Claude to manage your Google Calendar events.   
+   **Note:** When using the server for the first time, Google will prompt you to authenticate and grant permission to access your calendar.
+
+---
+## 🎬 In Action
+
+
+https://github.com/user-attachments/assets/75da4943-15c4-4ec2-bc5d-af4af3509031
+
+
+
+---
+
+## 📬 Support
+For issues or questions, please open an issue in this repository.

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+calendar_mcp.py,sha256=Gy0pXXMgBAGrBIFe9or2n73aB3dlOer_-BpKvPnrwMo,4331
+services.py,sha256=gmGXVLeO9skWPe0ldJtpEjdSDHm-C_ojHXnjaUeeNEE,10540
+iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/METADATA,sha256=QI-VAptLLE1mx0vXLl7eOuazv7A4io0tAJX3i77RtPw,3405
+iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/entry_points.txt,sha256=hPYApG5HVY_rDtWuFtoMmXklKojxtdzUARenZaGzzFo,58
+iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/RECORD,,

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+google-calendar-mcp = calendar_mcp:main

services.py

@@ -0,0 +1,309 @@
+import os
+from google.oauth2.credentials import Credentials
+from google_auth_oauthlib.flow import InstalledAppFlow
+from google.auth.transport.requests import Request
+from googleapiclient.discovery import build
+from datetime import datetime
+
+
+class CalenderService:
+    def __init__(self):
+        self.__calender_service = None
+        self.__scope = ["https://www.googleapis.com/auth/calendar"]
+
+    def __call__(self):
+        """
+        Returns a Calendar API service object.
+        """
+        if self.__calender_service is None:
+            try:
+                creds = None
+                # Check if token.json file exists with saved credentials
+                if os.path.exists("token.json"):
+                    creds = Credentials.from_authorized_user_file(
+                        "token.json", self.__scope
+                    )
+
+                # If credentials don't exist or are invalid, get new ones
+                if not creds or not creds.valid:
+                    if creds and creds.expired and creds.refresh_token:
+                        creds.refresh(Request())
+                    else:
+                        # flow instance using client secrets file from Google Cloud Console
+                        flow = InstalledAppFlow.from_client_secrets_file(
+                            "credentials.json", self.__scope
+                        )
+                        # Run the authorization flow in local server mode
+                        creds = flow.run_local_server(port=0)
+
+                    # Save the credentials for the next run
+                    with open("token.json", "w") as token:
+                        token.write(creds.to_json())
+
+                # Build and return the service object
+                self.__calender_service = build("calendar", "v3", credentials=creds)
+            except Exception:
+                print("Calendar service could not be initialized")
+
+        return self.__calender_service
+
+
+# singleton
+calender_service = CalenderService()
+
+
+async def list_events(
+    summary: str | None = None,
+    description: str | None = None,
+    location: str | None = None,
+    timeMin: str | None = None,
+    timeMax: str | None = None,
+    maxResults: int = 10,
+) -> str:
+    """
+    Retrieve a list of calendar events based on specified filters.
+
+    This function queries the calendar for events that match the given criteria.
+    All filter parameters are optional and can be used in combination to narrow
+    down the results.
+
+    Args:
+        summary (str, optional): Filter events by their summary (title or subject).
+        description (str, optional): Filter events by text found in the event description.
+        location (str, optional): Filter events based on their location.
+        timeMin (str, optional): ISO 8601 formatted lower time bound (exclusive)
+            for filtering events by end time. Must be in local time and have timezone offset.
+        timeMax (str, optional): ISO 8601 formatted upper time bound (exclusive)
+            for filtering events by start time. Must be in local time and have timezone offset.
+        maxResults (int, optional): Maximum number of events to return.
+
+    Returns:
+        list: A list of event objects that match the provided filters.
+    """
+    service = calender_service()
+    if service is None:
+        return "Unable to communicate with the Google Calendar Service."
+
+    # datetime validation
+    try:
+        if timeMin is None:
+            timeMin = datetime.now().astimezone().isoformat()
+        timeMin = datetime.fromisoformat(timeMin).astimezone().isoformat()
+    except Exception:
+        return "timeMin in incorrect format. It should be in ISO format"
+
+    try:
+        timeMax = (
+            datetime.fromisoformat(timeMax).astimezone().isoformat()
+            if timeMax is not None
+            else None
+        )
+    except Exception:
+        return "timeMax in incorrect format. It should be in ISO format"
+
+    try:
+        maxResults = int(maxResults)
+    except Exception:
+        maxResults = 10
+
+    search_parameters = [x for x in [summary, description, location] if x is not None]
+    search_query = " ".join(search_parameters)
+
+    events_result = (
+        service.events()
+        .list(
+            calendarId="primary",
+            timeMin=timeMin,
+            timeMax=timeMax,
+            maxResults=maxResults,
+            singleEvents=True,
+            orderBy="startTime",
+            q=search_query,
+        )
+        .execute()
+    )
+
+    events = events_result.get("items", [])
+
+    if not events:
+        return "No upcoming events found."
+
+    events_info = []
+    for i, event in enumerate(events):
+        start = event["start"].get("dateTime", event["start"].get("date"))
+        if start:
+            start = (
+                datetime.fromisoformat(start).astimezone().strftime("%Y-%m-%d %H:%M:%S")
+            )
+        end = event["end"].get("dateTime", event["end"].get("date"))
+        if end:
+            end = datetime.fromisoformat(end).astimezone().strftime("%Y-%m-%d %H:%M:%S")
+        summary = event.get("summary", "N/A")
+        description = event.get("description", "N/A")
+        location = event.get("location", "N/A")
+        event_id = event.get("id", "N/A")
+
+        event_info = f"""
+index: {i + 1}
+start: {start}
+end: {end}
+summary: {summary}
+description: {description}
+location: {location}
+event_id: {event_id}
+"""
+
+        events_info.append(event_info)
+
+    return "\n--\n".join(events_info)
+
+
+async def create_event(
+    start: str,
+    end: str,
+    timeZone: str,
+    summary: str | None = None,
+    description: str | None = None,
+    location: str | None = None,
+) -> str:
+    """
+    Creates a calendar event using the provided details.
+
+    Args:
+        start (str): Event start time in ISO 8601 format (e.g., '2025-04-06T10:00:00-04:00').
+        end (str): Event end time in ISO 8601 format (e.g., '2025-04-06T11:00:00-04:00').
+        timeZone (str): User timezone formatted as an IANA Time Zone Database name (e.g. "Europe/Zurich").
+        summary (str, optional): Short title or subject of the event.
+        description (str, optional): Detailed description or notes for the event. Defaults to None.
+        location (str, optional): Physical or virtual location of the event. Defaults to None.
+    """
+
+    service = calender_service()
+    if service is None:
+        return "Unable to communicate with the Google Calendar Service."
+
+    # datetime validation
+    try:
+        datetime.fromisoformat(start)
+    except Exception:
+        return "Event start time not in ISO format"
+
+    try:
+        datetime.fromisoformat(end)
+    except Exception:
+        return "Event end time not in ISO format"
+
+    event = {
+        "start": {"dateTime": start, "timeZone": timeZone},
+        "end": {"dateTime": end, "timeZone": timeZone},
+    }
+
+    for key, value in zip(
+        ["summary", "description", "location"], [summary, description, location]
+    ):
+        if value is not None:
+            event[key] = value
+
+    try:
+        event = service.events().insert(calendarId="primary", body=event).execute()
+        return f"Event created with id {event.get('id')}"
+    except Exception:
+        return "Event could not be created."
+
+
+async def delete_event(event_id: str):
+    """
+    Deletes an event from the calender.
+
+    Args:
+        event_id: Event identifier.
+    """
+
+    service = calender_service()
+    if service is None:
+        return "Unable to communicate with the Google Calendar Service."
+
+    try:
+        service.events().delete(calendarId="primary", eventId=event_id).execute()
+        return f"Event with id {event_id} is deleted."
+    except Exception:
+        return "Event could not be deleted."
+
+
+async def update_event(
+    event_id: str,
+    start: str | None = None,
+    end: str | None = None,
+    timeZone: str | None = None,
+    summary: str | None = None,
+    description: str | None = None,
+    location: str | None = None,
+):
+    """
+    Updates an event by replacing specified fields with new values.
+    Any fields not included in the request will retain their existing values.
+
+    Args:
+        event_id (str): Event identifier.
+        start (str, optional): Event start time in ISO 8601 format (e.g., '2025-04-06T10:00:00-04:00'). Defaults to None.
+        end (str, optional): Event end time in ISO 8601 format (e.g., '2025-04-06T11:00:00-04:00'). Defaults to None.
+        timeZone (str, optional): User timezone formatted as an IANA Time Zone Database name (e.g. "Europe/Zurich"). Defaults to None.
+        summary (str, optional): Short title or subject of the event. Defaults to None.
+        description (str, optional): Detailed description or notes for the event. Defaults to None.
+        location (str, optional): Physical or virtual location of the event. Defaults to None.
+    """
+    
+    service = calender_service()
+    if service is None:
+        return "Unable to communicate with the Google Calendar Service."
+    
+    updates = {}
+    updated_parameters = set()
+    
+    if start is not None:
+        try:
+            datetime.fromisoformat(start)
+        except Exception:
+            return "Event start time not in ISO format"
+        updates['start'] = {}
+        updates['start']['dateTime'] = start
+        updated_parameters.add("start")
+        
+    if end is not None:
+        try:
+            datetime.fromisoformat(end)
+        except Exception:
+            return "Event start time not in ISO format"
+        updates['end'] = {}
+        updates['end']['dateTime'] = end
+        updated_parameters.add("end")
+        
+    if timeZone is not None:
+        if "start" not in updates:
+            updates["start"] = {}
+        updates['start']['timeZone'] = timeZone
+        updated_parameters.add("start")
+        
+        if "end" not in updates:
+            updates["end"] = {}
+        updates['end']['timeZone'] = timeZone
+        updated_parameters.add("end")
+        
+    for key, value in zip(
+        ["summary", "description", "location"], [summary, description, location]
+    ):
+        if value is not None:
+            updates[key] = value
+            updated_parameters.add(key)
+            
+    updated_parameters = ",".join(updated_parameters)
+    try:
+        _ = service.events().patch(calendarId='primary', eventId=event_id, body=updates).execute()
+        return f"Event with id {event_id} updated with [{''.join(updated_parameters)}] "
+    except Exception:
+        return "Event could not be updated."
+    
+            
+        
+    
+