MCP iCal 服务器

🗓️ macOS 自然语言日历管理

🌟 概述

使用自然语言改变你与 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 一起使用。

克隆并设置

# 克隆仓库
git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-ical

# 安装依赖
uv sync

配置 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"
            ]
        }
    }
}

启动 Claude 以访问日历

⚠️ 关键：Claude 必须从终端启动，以正确请求日历权限。直接从 Finder 启动不会触发权限提示。

在终端中运行以下命令。
```
/Applications/Claude.app/Contents/MacOS/Claude
```
⚠️ 警告：或者，你可以手动授予日历访问权限，但这涉及修改系统文件，只有在了解风险的情况下才应进行。

开始使用！

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

🔑 注意：当你第一次使用与日历相关的命令时，macOS 会提示你授予日历访问权限。只有当你按照上述方式从终端启动 Claude 时，才会出现此提示。

🧪 测试

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

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

# 运行测试套件
uv run pytest tests

🐛 已知问题

重复事件

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

🤝 贡献

欢迎反馈和贡献。以下是你如何提供帮助：

Fork 仓库
创建你的功能分支
提交你的更改
推送到分支
打开一个 Pull Request

📝 许可证

此项目根据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

🙏 致谢

使用 Model Context Protocol 构建
macOS 日历集成使用 PyObjC 构建