MCP iCal Server

MCP iCal 服务器

🗓️ macOS 的自然语言日历管理

🌟 概述

使用自然语言改变您与 macOS 日历的交互方式！mcp-ical 服务器利用模型上下文协议 (MCP)，将您的日历管理转变为对话式体验。

✨ 特点

📅 活动创建

立即将自然语言转换为日历事件！

支持的功能

• 自定义日历选择
• 地点和说明
• 智能提醒
• 重复事件

高级用户示例

🔍 智能日程管理和可用性

通过自然查询快速访问您的日程安排：

✏️ 智能事件更新

自然地修改事件：

更新功能

• 时间和日期修改
• 日历传输
• 位置更新
• 注释补充
• 提醒调整
• 重复的模式变化

📊 日历管理

• 查看所有可用日历
• 智能日历建议
• 配置 iCloud 后可无缝集成 Google 日历

💡专业提示：由于您可以在自定义日历中创建活动，如果您已将 Google 日历与 iCloud 日历同步，那么您也可以使用此 MCP 服务器在 Google 日历中创建活动！只需在创建/更新活动时指定 Google 日历即可。

🚀 快速入门

💡注意：虽然本指南主要介绍如何使用 Claude for Desktop 设置 MCP 服务器，但该服务器可以与任何兼容 MCP 的客户端一起使用。有关使用不同客户端的更多详细信息，请参阅MCP 文档。

先决条件

• uv 包管理器
• 配置了日历应用的 macOS
• 推荐使用 MCP 客户端 - Claude 桌面版

安装

虽然此 MCP 服务器可以与任何兼容 MCP 的客户端一起使用，但以下说明适用于桌面版 Claude。

1. 克隆和设置
   # Clone the repository git clone https://github.com/Omar-V2/mcp-ical.git cd mcp-ical # Install dependencies uv sync
2. 配置 Claude 桌面版创建或编辑~/Library/Application\ Support/Claude/claude_desktop_config.json ：
   { "mcpServers": { "mcp-ical": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical", "run", "mcp-ical" ] } } }
3. 启动 Claude 以访问日历

   ⚠️重要提示：必须从终端启动 Claude 才能正确请求日历权限。直接从 Finder 启动不会触发权限提示。

   在终端中运行以下命令。
   /Applications/Claude.app/Contents/MacOS/Claude

   ⚠️警告：或者，您可以手动授予日历访问权限，但这涉及修改系统文件，并且只有在您了解所涉及的风险时才应这样做。

4. 开始使用！
   Try: "What's my schedule looking like for next week?"

🔑注意：首次使用日历相关命令时，macOS 会提示访问日历。仅当您按照上述说明从终端启动 Claude 时，才会出现此提示。

🧪 测试

⚠️警告：测试将创建临时日历和事件。虽然清理是自动的，但请仅在开发环境中运行测试。

🐛 已知问题

重复事件

• 非标准重复计划可能并不总是设置正确
• Claude 3.5 Sonnet 与 Haiku 相比效果更佳
• 全天重复事件的提醒时间可能会偏差一天

🤝 贡献

欢迎提供反馈和贡献。您可以通过以下方式提供帮助：

1. 分叉存储库
2. 创建你的功能分支
3. 提交你的更改
4. 推送到分支
5. 打开拉取请求

📝 许可证

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

🙏 致谢

• 使用模型上下文协议构建
• 使用PyObjC构建的 macOS 日历集成