AI导哈

日历管理MCP服务

一个MCP（模型上下文协议）服务器，允许AI助手直接访问和管理Google日历，包括查看、创建、删除事件以及查找空闲时间。

  • by AaKa5204
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 AaKa5204/Google-Calender-MCP

使用说明

谷歌日历MCP服务器

🤖 MCP（模型上下文协议）服务器，使Kiro等人工智能助手可以直接访问您的谷歌日历。

让你的人工智能检查你的日程安排、创建活动、寻找空闲时间和管理你的日历——所有这些都是通过自然对话完成的。

✨ 特性

  • 📅 列出事件 -查看今天、明天、本周或自定义范围的事件
  • ➕ 创建事件 -添加包含详细信息的新日历事件
  • 🗑️ 删除事件 -按ID删除事件
  • 🔍 搜索事件 -按关键字查找事件
  • 🕐 查找免费老虎机 -发现可用的时间段

🚀 快速开始

1.克隆和安装

git clone https://github.com/YOUR_USERNAME/google-calendar-mcp.git
cd google-calendar-mcp
pip install -e .

2.获取谷歌凭据

看 设置.md 获取有关获取Google日历API凭据的详细说明。

快速版本：

  1. 首选 谷歌云控制台
  2. 创建项目→ 启用日历API→ 创建OAuth凭据
  3. 下载并保存到 ~/.google-calendar-mcp/credentials.json

3.配置Kiro

增添 .kiro/settings/mcp.json:

{
  "mcpServers": {
    "google-calendar": {
      "command": "python",
      "args": ["-m", "calendar_mcp.server"],
      "cwd": "/path/to/google-calendar-mcp",
      "disabled": false
    }
  }
}

4.身份验证

首次使用将打开浏览器登录谷歌。就是这样！

使用示例

列出今天的活动

You: "Kiro, what's on my calendar today?"

创建事件

You: "Kiro, schedule a team meeting tomorrow at 2 PM for 1 hour"

寻找空闲时间

You: "Kiro, when am I free for a 30-minute meeting this week?"

搜索事件

You: "Kiro, find all my dentist appointments"

删除事件

You: "Kiro, delete the event with ID abc123xyz"

可用工具

list_事件

列出某个时间范围的日历事件。

参数：

  • time_range：“今天”、“明天”、“本周”、“下周”或“自定义”
  • max_results：要返回的最大事件数（默认值：10）
  • start_date：用于自定义范围（可选）
  • end_date：用于自定义范围（可选）

create_event

创建新的日历事件。

参数：

  • summary：活动标题（必填）
  • start_time：开始时间（必填）
  • end_time：结束时间（必填）
  • description：事件描述（可选）
  • location：活动地点（可选）
  • attendees：电子邮件地址列表（可选）

删除事件

删除日历事件。

参数：

  • event_id：要删除的事件ID（必填）

find_free_slots

查找可用的时间段。

参数：

  • duration_minutes：所需持续时间（默认值：60）
  • days_ahead：搜索天数（默认值：7）
  • work_hours_only：仅上午9点至下午5点（默认值：true）

搜索事件

按关键字搜索事件。

参数：

  • query：搜索词（必填）
  • max_results：最大结果（默认值：10）

故障排除

“未找到credentials.json”

确保您已从Google Cloud Console下载OAuth凭据并将其保存到 ~/.google-calendar-mcp/credentials.json

“授予无效”或“令牌已过期”

删除 ~/.google-calendar-mcp/token.json 并重新验证

权限错误

确保在您的Google Cloud项目中启用Google日历API

安全说明

  • 永不承诺 credentials.json 或 token.json 到版本控制
  • 该令牌可以访问您的日历，请确保其安全
  • 随时从您的 Google帐户设置

发展

项目结构：

google-calendar-mcp/
├── pyproject.toml
├── README.md
└── src/
    └── calendar_mcp/
        ├── __init__.py
        ├── server.py      # MCP server implementation
        └── auth.py        # Google OAuth handling

🤝 贡献

欢迎投稿！看 贡献.md 作为指导方针。

贡献想法：

  • 重复事件支持
  • 事件更新/修改
  • 多日历支持
  • 更好的自然语言解析
  • 单元测试

📝 许可证

MIT许可证-请参阅 许可证 详细信息文件

🙏 致谢

⭐ Star This Repo

如果你觉得这个有用，就给它一颗星！它帮助其他人发现项目。

由...制作❤️ 对于MCP社区

相关 MCP