MCP Google Calender

谷歌日历MCP服务器

这个项目是一个持久的、基于Python的MCP（模型上下文协议）服务器，充当MCP客户端（如Claude Desktop）和您的Google Calendar API之间的桥梁。

它将日历公开为LLM可以使用的一组工具（创建、读取、更新、删除）。感谢本地SQLite数据库安全地存储您的谷歌 refresh_token，您只需通过基于浏览器的身份验证流程 一次之后，服务器可以在后台运行，并始终为Claude做好准备。

______________________________________________________________________

✨ 特性

• 完整CRUD：

- get_events （阅读） - create_event （创建） - update_event （更新） - delete_event （删除）

• 持久身份验证： 使用本地SQLite数据库(sql_app.db)安全地存储您的Google OAuth refresh_token.
• 简单的一次性设置： A内置 --auth flag会启动一个临时网络服务器，以便从谷歌轻松获取您的令牌。
• stdio 运输： 设计由Claude Desktop自动启动和管理。
• 安全： 客户端中不需要API密钥。服务器在后台处理所有令牌刷新。

______________________________________________________________________

🔧 安装和设置

您需要获取谷歌凭据，设置项目，并进行一次身份验证。

步骤1：获取Google凭据

在你开始之前，你必须从谷歌获得你自己的API证书。

1. 转到 谷歌云控制台.
2. 创建一个新项目。
3. 首选 “API和服务”->“库” 并启用 “Google日历API”.
4. 首选 “API和服务”->“OAuth同意屏幕”.

- 选择 “外部” 并填写必填字段（应用程序名称、用户支持电子邮件）。 - 在“范围”页面上，添加 .../auth/calendar 和 .../auth/userinfo.email 范围。 - 在“测试用户”页面上，添加您计划使用的谷歌电子邮件帐户（例如。， you@gmail.com).

1. 首选 “API和服务”->“凭据”.

- 点击 “+创建凭据”->“OAuth客户端ID”. - 选择 “Web应用程序” 对于应用程序类型。 - 在“授权重定向URI”下，单击“+添加URI”并添加： http://127.0.0.1:8000/auth/google/callback

1. 单击“创建”。谷歌会给你一个 客户端ID 和一个 客户端密钥复制这些。

步骤2：克隆并安装

1. 克隆存储库：

   git clone 
   cd mcp-google-calender

1. 创建虚拟环境并激活它：

   # On macOS/Linux
   python3 -m venv .venv
   source .venv/bin/activate

   # On Windows
   python -m venv .venv
   .\.venv\Scripts\activate

1. 安装所需的软件包：

   pip install -r requirements.txt

1. 创建一个 .env 在项目的根目录中创建文件，并添加您从谷歌获得的凭据：

   # .env
   GOOGLE_CLIENT_ID=YOUR_CLIENT_ID_HERE.apps.googleusercontent.com
   GOOGLE_CLIENT_SECRET=YOUR_CLIENT_SECRET_HERE

步骤3：通过谷歌授权（仅限一次）

您必须运行此步骤一次才能创建数据库并获取 refresh_token.

1. 运行身份验证服务器：

   python main.py --auth

1. 您的终端将显示：

Starting one-time auth server on http://127.0.0.1:8000 Please open http://127.0.0.1:8000/auth/google in your browser.

1. 在浏览器中打开该URL，登录您的Google帐户，并授予权限。
2. 您将被重定向到成功页面。现在，您可以停止终端中的服务器(Ctrl+C).
3. 一个新的数据库文件， sql_app.db，现在将位于您的项目中 ~/Library/Application Support/mcp-google-calender/ 目录。您的令牌已安全存储。

步骤4：连接到克劳德桌面

这是告诉Claude如何运行服务器的最后一步。

1. 查找 绝对路径 到项目的Python可执行文件。当你的venv处于活动状态时，运行：

   # On macOS/Linux
   which python
   # Example output: /Users/yourname/Code/mcp-google-calender/.venv/bin/python

   # On Windows
   where python
   # Example output: C:\Users\yourname\Code\mcp-google-calender\.venv\Scripts\python.exe

1. 查找 绝对路径 你的 main.py 文件。在项目文件夹中，运行：

   # On macOS/Linux
   pwd
   # Example output: /Users/yourname/Code/mcp-google-calender
   # (So your script path is /Users/yourname/Code/mcp-google-calender/main.py)

   # On Windows
   cd
   # Example output: C:\Users\yourname\Code\mcp-google-calender
   # (So your script path is C:\Users\yourname\Code\mcp-google-calender\main.py)

1. 打开克劳德桌面，转到 设置 -> 开发者 -> 编辑配置.

1. 将以下内容添加到 mcpServers 对象，使用 绝对路径 你刚刚发现。

   {
     "mcpServers": {
       "google_calendar": {
         "command": "/ABSOLUTE/PATH/TO/YOUR/.venv/bin/python",
         "args": [
           "/ABSOLUTE/PATH/TO/YOUR/main.py"
         ],
         "cwd": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/FOLDER"
       }
     }
   }

- command：Python可执行文件的完整路径（从步骤4.1开始）。 - args：一个包含您的完整路径的列表 main.py 脚本。 - cwd：通往 *文件夹* 包含 main.py 和 .env （从步骤4.2开始）。这对于服务器找到您的 .env 文件。 - *（Windows用户：记得使用双反斜杠 \\ JSON文件中的路径。)*

______________________________________________________________________

🚀 用法

1. 完全退出并重新启动Claude Desktop 以使更改生效。
2. 打开新聊天。您应该在聊天栏中看到“搜索和工具”（滑块）图标。
3. 如果你点击它，你会看到 google_calendar 服务器及其四个工具：

- get_events - create_event - update_event - delete_event

1. 现在，您可以让克劳德管理您的日历！

示例提示：

• “明天我的日历上有什么？”
• “为本周五下午3点创建一个名为“医生预约”的活动。”
• “找到“医生预约”事件，并将其时间更改为下午4点。”
• “删除事件‘医生预约’。”

______________________________________________________________________

📄 许可证

这个项目是在MIT许可证下开源的。