内容
# 提醒事项MCP
一个MCP服务器，通过[`remindctl`](https://github.com/steipete/remindctl)为克劳德（以及任何MCP客户端）提供对苹果提醒事项的完全访问权限。
## 功能描述
10种工具，均返回JSON：
| 工具 | 描述 |
|---|---|
| `显示提醒事项` | 按`今天` / `明天` / `本周` / `逾期` / `即将到期` / `打开` / `已完成` / `全部` / `年-月-日`筛选 |
| `列出提醒事项列表` | 列出所有提醒事项列表 |
| `获取列表内容` | 显示特定列表中的提醒事项 |
| `搜索提醒事项` | 在标题、备注和网址中进行全文搜索 |
| `获取提醒事项信息` | 通过索引或ID前缀获取单个提醒事项的详细信息 |
| `添加提醒事项` | 创建带有截止日期、闹钟、备注、网址、优先级、重复等属性的提醒事项 |
| `编辑提醒事项` | 编辑现有提醒事项的任意字段 |
| `完成提醒事项` | 标记一个或多个提醒事项为已完成 |
| `删除提醒事项` | 删除一个或多个提醒事项 |
| `创建列表` | 创建新的提醒事项列表 |
## 要求
- macOS
- [remindctl](https://github.com/steipete/remindctl) — `brew install steipete/tap/remindctl`
- Python 3.12+
- `mcp` Python包 — `pip3 install mcp`
## 设置
**1. 安装依赖**
```bash
brew install steipete/tap/remindctl
pip3 install mcp
```
**2. 授权提醒事项访问**
```bash
remindctl authorize
```
**3. 克隆此仓库**
```bash
git clone https://github.com/YOUR_USERNAME/RemindersMCP.git ~/RemindersMCP
```
**4. 添加到克劳德桌面配置**
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json` 并添加：
```json
{
"mcpServers": {
"RemindersMCP": {
"command": "python3",
"args": ["/Users/YOUR_USERNAME/RemindersMCP/server.py"]
}
}
}
```
**5. 重启克劳德桌面**
10种工具将自动出现。
## 使用示例
连接后，您可以问克劳德类似的问题：
- *"今天我有什么任务？"*
- *"添加一个提醒事项，在明天9点给妈妈打电话，优先级高"*
- *"在我的提醒事项中搜索与牙医有关的内容"*
- *"标记提醒事项3为已完成"*
- *"将'查看文档'的提醒事项移到我的工作列表，并设置截止日期为周五"*
## 工作原理
每个工具都使用`remindctl`并带有`--json --no-input`标志，以便所有输出都是机器可读的。服务器通过标准输入/输出（标准MCP传输）运行，因此不需要端口或守护进程。
## 许可证
MIT
