MCP iCal 服务器

<div align="center">

🗓️ macOS 自然语言日历管理

</div>

🌟 概述

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

您：“下周我的日程安排是什么？”
Claude：“让我为您查一下……”
[显示您即将到来的一周的清晰概览]

您：“明天中午与 Sarah 共进午餐”
Claude：“✨ 📅 已创建：明天中午 12:00 与 Sarah 共进午餐”

✨ 功能

📅 事件创建

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

“安排下周四下午 1 点在 Bistro Garden 的团队午餐”
↓
📎 已创建：团队午餐
   📅 星期四，下午 1:00
   📍 Bistro Garden

支持的功能：

• 自定义日历选择
• 地点和备注
• 智能提醒
• 循环事件

高级用户示例：

🔄 循环事件：
“设置我的每周团队同步，每周一上午 9 点，提前 15 分钟提醒”

📝 详细事件：
“安排明天下午 2-4 点在工程日历中进行产品评审会议，
添加关于评审 Q1 指标的备注，并在 1 小时前提醒我”

📱 多日历支持：
“将下周三下午 3 点的牙医预约添加到我的个人日历”

🔍 智能日程管理和可用性

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

“下周我的日历上有什么？”
↓
📊 以智能格式显示您即将到来的事件

“下周二我什么时候有空安排一个 2 小时的会议？”
↓
🕒 找到可用时间段：
   • 星期二上午 10:00 - 中午 12:00
   • 星期二下午 2:00 - 下午 4:00

✏️ 智能事件更新

自然地修改事件：

之前：“将明天的团队会议改为下午 3 点”
↓
之后：✨ 会议已重新安排至下午 3:00

更新功能：

• 时间和日期修改
• 日历转移
• 地点更新
• 备注添加
• 提醒调整
• 循环模式更改

📊 日历管理

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

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

🚀 快速开始

💡 注意：虽然这些说明侧重于使用 Claude for Desktop 设置 MCP 服务器，但此服务器可以与任何 MCP 兼容的客户端一起使用。 有关使用不同客户端的更多详细信息，请参阅 MCP 文档。

前提条件

• uv 包管理器
• 配置了日历应用程序的 macOS
• 一个 MCP 客户端 - 推荐 Claude for desktop

安装

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

1. 克隆和设置

# 克隆存储库
git clone https://github.com/yourusername/mcp-ical.git
cd mcp-ical

# 安装依赖项
uv sync

2. 配置 Claude for Desktop

创建或编辑 ~/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. 开始使用！

尝试：“下周我的日程安排如何？”

🔑 注意：当您第一次使用与日历相关的命令时，macOS 会提示您访问日历。 只有在您按照上述指定从终端启动 Claude 时，才会出现此提示。

🧪 测试

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

# 安装开发依赖项
uv sync --dev

# 运行测试套件
uv run pytest tests

🐛 已知问题

循环事件

• 非标准循环计划可能无法始终正确设置
• 与 Haiku 相比，Claude 3.5 Sonnet 的效果更好
• 循环全天事件的提醒时间可能相差一天

🤝 贡献

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

1. Fork 存储库
2. 创建您的功能分支
3. 提交您的更改
4. 推送到分支
5. 打开一个 Pull Request

📝 许可证

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

🙏 鸣谢

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