使用说明
苹果提醒MCP服务器
MCP（模型上下文协议）服务器，将Apple提醒操作作为工具公开，使用 FastMCP 和 pyobjc框架事件工具包.
注： 此服务器需要macOS通过EventKit访问Apple提醒。
安装
自制（推荐）
brew install 0xalexb/tap/apple-reminders-mcp
使用紫外线（如果你已经有紫外线）
无需安装——将MCP客户端配置为直接使用uvx：
{
"mcpServers": {
"apple-reminders": {
"command": "uvx",
"args": ["--from", "git+https://github.com/0xalexb/apple-reminders-mcp", "apple-reminders-mcp"]
}
}
}
来源（开发）
git clone https://github.com/0xalexb/apple-reminders-mcp.git
cd apple-reminders-mcp
uv sync
MCP配置
克劳德代码
添加到您的Claude Code MCP设置中(~/.claude/settings.json 或项目 .mcp.json):
{
"mcpServers": {
"apple-reminders": {
"command": "apple-reminders-mcp"
}
}
}
克劳德桌面版
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"apple-reminders": {
"command": "apple-reminders-mcp"
}
}
}
可用工具
| 工具 | 说明 |
|---|---|
ping |
健康检查-返回“pong” |
list_reminder_lists |
返回所有提醒列表名称及其不完整的提醒计数 |
create_list |
创建新的提醒列表 |
show_incomplete_reminders |
返回特定列表的不完整提醒，包括标题、截止日期、优先级和注释 |
show_all_incomplete_reminders |
返回按列表分组的所有未完成提醒 |
create_reminder |
创建具有可选列表、截止日期（ISO 8601）、优先级（无/低/中/高）、重复（每日/每周/每月/每年）和注释的提醒 |
complete_reminder |
通过ID将提醒标记为已完成 |
delete_reminder |
按ID删除提醒 |
move_reminder |
将提醒移动到其他列表 |
quick_capture |
只需标题和可选注释，即可在默认列表中快速捕获提醒 |
发展
# Run tests
uv run pytest
# Run tests with coverage
uv run pytest --cov=apple_reminders_mcp
# Run linter
uv run ruff check src/ tests/
建筑
src/apple_reminders_mcp/server.py-带工具定义的FastMCP服务器src/apple_reminders_mcp/eventkit_service.py-EventKit服务层包装pyobjc调用tests/-带有模拟EventKit对象的测试套件（在任何平台上运行）
卸载
家酿
brew uninstall apple-reminders-mcp
# Optional: remove the tap
brew untap 0xalexb/tap
uvx
uv cache prune
许可证
麻省理工学院
