# Avik-creator
## 基本信息
- Slug: `avik-creator-googlecalendarmcp`
- Source: modelscope
- Publisher: @Avik-creator/googlecalendarMCP
- Categories: calendar-management / app-automation
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@Avik-creator/googlecalendarMCP
## 简介
暂无描述。
## MCP Server 详情

# Google 日历集成项目
[![smithery 徽章](https://smithery.ai/badge/@Avik-creator/googlecalendarMCP)](https://smithery.ai/server/@Avik-creator/googlecalendarMCP)

该项目提供了与 Google 日历 API 的集成，以便通过编程方式管理和交互日历事件。

## 前提条件

- Python 3.8 或更高版本
- Google Cloud Platform 账户
- 启用 Google 日历 API
- 配置 OAuth 2.0 凭证

## 设置说明

### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@Avik-creator/googlecalendarMCP) 自动为 Claude Desktop 安装 Google 日历集成项目：

bash
npx -y smithery install @Avik-creator/googlecalendarMCP --client claude


### 手动安装
1. **克隆仓库**
   bash
   git clone https://github.com/Avik-creator/googlecalendarMCP
   cd googlecalendarMCP
   

2. **设置虚拟环境**
   bash
   python -m venv venv
   source venv/bin/activate  # 在 Windows 上使用 `venvScriptsactivate`
   

3. **安装依赖项**
   bash
   pip install -r requirements.txt
   

4. **Google Cloud Platform 设置**

   a. 访问 [Google Cloud 控制台](https://console.cloud.google.com/)
   b. 创建新项目或选择现有项目
   c. 启用 Google 日历 API
   d. 创建 OAuth 2.0 凭证：
      - 转到 APIs & Services > Credentials
      - 点击 "Create Credentials" > "OAuth client ID"
      - 选择 "Desktop Application"
      - 下载凭证 JSON 文件
      - 将其重命名为 `credentials.json` 并放置在项目根目录中

5. **环境变量**

   在项目根目录中创建一个 `.env` 文件，并包含以下变量：
   
   GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
   CALENDAR_ID=your_calendar_id@group.calendar.google.com
   

## 使用方法

1. **首次认证**
   bash
   python auth.py
   
   这将打开一个浏览器窗口进行 OAuth 认证。按照提示授权应用程序。

2. **运行应用程序**
   bash
   python main.py
   

## 功能

- 创建、读取、更新和删除日历事件
- 设置重复事件
- 管理事件参与者
- 处理事件通知和提醒

## 项目结构


googlecalendarMCP/
├── auth.py              # 认证处理
├── main.py             # 主应用程序入口点
├── requirements.txt    # 项目依赖项
├── .env               # 环境变量
├── credentials.json   # Google OAuth 凭证
└── token.json        # 生成的 OAuth 令牌


## 依赖项

该项目使用的主要依赖项包括：
- google-auth-oauthlib
- google-auth-httplib2
- google-api-python-client
- python-dotenv

## 部署配置

json
{
  "mcpServers": {
    "google_calendar_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-google-calendar.avikm744.workers.dev/sse"
      ]
    }
  }
}


## 安全注意事项

- 永远不要将 `credentials.json`、`token.json` 或 `.env` 文件提交到版本控制系统
- 保护好您的 OAuth 凭证
- 定期轮换您的凭证和令牌

## 贡献

1. 叉分仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求

## 许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。