py
一个基于Python的MCP服务器,用于异步访问和管理Google日历。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:py。 它的用途是:一个基于Python的MCP服务器,用于异步访问和管理Google日历。 详细介绍见:https://321skill.com/skills/py-py-mcp-gcalendar/ 请根据该页面的说明完成安装。
使用示例
“查看我下周一下午两点以后的所有会议安排。”,它会通过此MCP服务器查询您的Google日历,并返回匹配的事件列表。或者,您可以说:“帮我在团队日历中创建一个关于项目评审的会议,时间是明天下午3点,时长1小时,并邀请开发组全体成员。”,AI会调用该Skill创建对应事件并发送邀请。
介绍
这个Skill是一个遵循Model Context Protocol (MCP) 标准的服务器,它封装了Google Calendar API的异步访问能力,允许AI助手或其他应用程序安全、高效地读取、创建和管理用户的日历事件。它解决了AI助手无法直接与个人或团队日历系统交互的问题,通过标准化的MCP接口,将日历功能无缝集成到AI工作流中。
使用前,您需要在Google Cloud Console创建项目并启用Calendar API,配置OAuth 2.0凭据,并将生成的credentials.json文件放置于项目目录。启动服务器后,支持MCP的AI客户端(如Claude Desktop)即可通过该服务器调用日历API。
它非常适合需要将日程管理与AI自动化结合的开发者和团队,特别是那些已经在使用MCP生态构建智能体应用的全栈开发、智能体开发者和项目经理。对于希望自动化会议安排、项目进度同步或日常提醒的个人用户也同样适用。
建议在使用时仔细配置OAuth同意屏幕和访问范围,确保仅授予必要的权限。由于涉及个人日程数据,请务必妥善保管credentials.json和生成的token.json文件,避免泄露。在服务器配置中,可以灵活设置时区、默认日历等参数以适应不同场景。
核心特点
这是一个专门为MCP协议设计的、纯Python实现的Google Calendar服务器,原生支持异步操作,相比通用日历API封装,它直接对接MCP标准,能更便捷地被Claude等AI助手调用;同时,它专注于日历功能的深度集成,而非泛化的Google服务套件。
注意事项
不适合需要离线操作或与Google Calendar之外的其他日历服务(如Outlook、iCal)进行集成的场景。
常见问题
如何获取Google API的credentials.json文件?
需要在Google Cloud Console创建项目,启用Calendar API,并在‘凭据’页面创建OAuth 2.0客户端ID,下载JSON文件即可。
这个Skill支持哪些具体的日历操作?
支持查看日历列表、查询事件、创建/更新/删除事件,以及管理日程提醒等核心功能。