AI导哈

Google日历MCP服务器

一个基于Typescript和Node.js的MCP服务器，允许Claude Desktop连接并与Google日历交互。

  • by RossiFire
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 rossifire/mcp-google-calendar

使用说明

🗓️ 谷歌日历MCP服务器

一个使用Typescript和nodejs制作的模型上下文协议（MCP）服务器，允许Claude Desktop连接谷歌日历并与之交互。

📕目录

特性

  • 将Claude Desktop AI连接到您的Google帐户
  • 检索日历列表和事件
  • 创建、更新和删除事件
  • 自动令牌管理

需求

  • Node.js（v16或更高版本）
  • npm或纱线
  • 具有日历访问权限的Google帐户
  • Google OAuth2凭据
  • 克劳德桌面

入门指南

由于这是一个本地服务器，您需要设置谷歌云项目才能使用它。这里有一个关于如何获取令牌的详细指南。

1.创建新项目

访问 谷歌云控制台，然后创建一个新项目。

2.谷歌云OAuth

  1. 转到 谷歌云控制台
  2. 创建新项目
  3. 首选 API和服务 > 凭证 选项卡>点击 创建新凭据.
  4. 选择 OAuth客户端ID 作为凭证类型和 Web应用程序 作为应用程序类型。然后为凭据设置一个名称，并添加授权的重定向URI，如下所示：

一旦完成，你应该有 客户端ID 和 客户端密钥.

安装

1.克隆存储库

git clone https://github.com/RossiFire/mcp-google-calendar
cd mcp-google-calendar

2.安装依赖项

npm install
# or
yarn install

3.配置环境变量

创建一个 .env 文件基于 .env.example:

cp .env.example .env

然后编辑 .env 使用您的配置文件：

CLIENT_ID=your_cliend_id
CLIENT_SECRET=your_client_secret

# This is random string rapresenting the secret for the express session. 
EXPRESS_SECRET=your_express_secret

4.建设项目

您需要构建MCP服务器 之前 请Claude连接到它，以便Claude Desktop能够使用它。

npm run build

配置Claude桌面

先决条件

  1. 您必须在计算机上安装Claude Desktop
  2. 您的Claude Desktop版本必须支持MCP连接

需要配置Claude Desktop以访问您的MCP服务器：

  1. 找到您的Claude Desktop设置文件：

    • 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 在Windows上： %APPDATA%\Claude\claude_desktop_config.json

  2. 将MCP服务器配置添加到设置文件中：

    • 在文本编辑器中打开settings.json文件
    • 查找或创建 mcpServers 章节
    • 添加以下配置：
     {
   "mcpServers": {
       "GoogleMCPCalendar": {
           "command": "node",
           "args": [
               "/path/to/project/folder/mcp-google-calendar/build/index.js"
           ],
           "env": {
               "CLIENT_ID": your_client_id,
               "CLIENT_SECRET": your_client_secret,
               "EXPRESS_SECRET": express_secret
           }
       }
   }
 }

  3. 保存文件并重新启动Claude Desktop

首次运行

安装后，当您打开Claude时，系统会要求您选择并使用Google帐户登录。登录后，您就可以使用它了！下次打开Claude时，不会要求您登录，因为令牌会自动保存和管理。

验证连接

连接后，您可以测试Claude AI，问一些简单的问题，比如：

What events do I have today?
What's on my calendar for next week?
etc...

安全考虑

  • 此MCP服务器将身份验证令牌本地存储在文件中，因此没有在线暴露的数据。确保这些文件未提交到版本控制。

贡献

请随时提交Pull Request。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP