iflow-mcp_rsc1102-google_calendar_mcp 0.1.0__tar.gz

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0/.gitignore

@@ -0,0 +1,18 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# mac specific
+.DS_Store
+
+# Seneitive files
+credentials.json
+token.json
+.env

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0/3473_process.log

@@ -0,0 +1,4 @@
+[2026-02-06 15:11:32] [SUCCESS] 步骤1: 获取项目 - fork和克隆成功
+[2026-02-06 15:11:32] [SUCCESS] 步骤2: 阅读代码 - Python项目，使用FastMCP，支持stdio协议
+[2026-02-06 15:13:02] [SUCCESS] 步骤3: 本地测试 - 构建和测试成功，获取到4个工具：list_events, create_event, delete_event, update_event
+[2026-02-06 15:13:12] [SUCCESS] 步骤4: 推送iflow分支 - 成功推送到远程仓库

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,96 @@
+# 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/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/language.json

@@ -0,0 +1 @@
+python

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0/package_name

@@ -0,0 +1 @@
+iflow-mcp_rsc1102-google_calendar_mcp

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0/push_info.json

@@ -0,0 +1,5 @@
+{
+  "push_platform": "github",
+  "fork_url": "https://github.com/iflow-mcp/rsc1102-google_calendar_mcp",
+  "fork_branch": "iflow"
+}

iflow_mcp_rsc1102_google_calendar_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "iflow-mcp_rsc1102-google_calendar_mcp"
+version = "0.1.0"
+description = "An MCP server to interact with Google Calendar"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "google-api-python-client>=2.166.0",
+    "google-auth>=2.38.0",
+    "google-auth-oauthlib>=1.2.1",
+    "mcp[cli]>=1.6.0",
+]
+
+[project.scripts]
+google-calendar-mcp = "calendar_mcp:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["calendar_mcp.py", "services.py"]