Macos Reminders

macOS提醒MCP服务器

Claude Code从…开始macOS的标准提醒应用程序MCP (Model Context Protocol) 服务器。

🚀 机能

• ✅ 获取提醒列表
• ✅ 创建、完成、删除提醒
• ✅ 关键字搜索
• ✅ 期限日设定
• ✅ Claude Code自然语言操作

📋 所需环境

• macOS (AppleScript），模板名称将采用不同的格式
• Node.js 18以降
• 克劳德代码

🛠️ 安装

1.克隆存储库

git clone https://github.com/atani/mcp-server-macos-reminders.git
cd mcp-server-macos-reminders

2.安装相关性

npm install

3.构建

npm run build

4. Claude Code设定

克劳德 Code的配置文件（~/.config/claude/claude_desktop_config.json在工作空间的边缘~/Library/Application Support/Claude/claude_desktop_config.json）中添加以下内容：

{
  "mcpServers": {
    "reminders": {
      "command": "node",
      "args": ["/path/to/mcp-server-macos-reminders/dist/index.js"],
      "env": {}
    }
  }
}

重要: /path/to/mcp-server-macos-reminders将条目添加到文档注册表。

5. macOS隐私设置

1. 系统设置 > 隐私和安全 > 铰刀的双曲正切值
2. 终端（或Claude

Code使用的应用程序）授予对提醒的访问权限

🎯 使用方法

基本操作

确认提醒列表

> リマインダーのリスト一覧を表示して

创建新提醒

> 「仕事」リストに「会議の準備」というリマインダーを追加して

> 「買うもの」リストに「牛乳を買う」を明日の17時までに追加して

完成提醒

> 「仕事」リストの「会議の準備」を完了にして

查找提醒

> 「動画」に関するリマインダーを検索して

> 未完了のリマインダーを「仕事」リストから検索して

删除提醒

> 「買うもの」リストの「牛乳を買う」を削除して

高级用例

成批创建过期提醒

> 来週のプロジェクトタスクを「仕事」リストに追加して：
> - 月曜日: 企画書作成
> - 水曜日: レビューミーティング
> - 金曜日: 最終確認

特定期间的提醒确认

> 今日期限のリマインダーをすべて表示して

> 今週中に期限が切れるリマインダーはある？

🔧 开発

以开发模式运行

npm run dev

测试运行

npm test

链接格式

npm run lint
npm run format

📚 可用命令

｜命令｜说明｜ | -------------------- | -------------------------------- | | get_reminder_lists 获取所有提醒列表 | get_reminders 获取指定列表的提醒 | create_reminder 创建新的提醒程序 | complete_reminder 将提醒设置为完成状态 | delete_reminder 删除提醒> | search_reminders 用关键字搜索提醒

🔍 故障排除

常见问题

“无法访问提醒应用程序”错误

解决方法:\ macOS终端（或Node.js）中所述修改相应参数的值。

1. 系统设置>隐私和安全>提醒
2. 打开相应应用程序的复选框

「AppleScript执行错误“

解决方法:

• 确认提醒应用程序已启动
• 确认指定的列表名称是否正确
• 包含特殊字符的列表名用“”括起来指定

Claude Code中未检测到服务器

解决方法:

1. 验证配置文件路径是否正确
2. Claude Code重新启动
3. MCP确保已构建服务器（npm run build）

调试方法

检查日志

# MCPサーバーを直接実行してログを確認
node dist/index.js

# デバッグモードで実行
DEBUG=mcp:* node dist/index.js

AppleScript手动测试

# リスト一覧の取得テスト
osascript -e 'tell application "Reminders" to get name of every list'

# 特定リストのリマインダー取得テスト
osascript -e 'tell application "Reminders" to get name of every reminder in list "仕事"'

🤝 分发

这个项目GitHub Actions进行动态观察时的轴心点。

开发工作流

1. 分叉此存储库
2. 创建功能分支（git checkout -b feature/amazing-feature)
3. 实施更改
4. 在本地运行测试

   npm run lint        # コード品質チェック
   npm run build       # ビルド検証
   npm run test        # テスト実行
   npm run test:coverage  # カバレッジチェック

1. 提交更改（git commit -m 'feat: add amazing feature')
2. 推到分支（git push origin feature/amazing-feature)
3. Pull Request创建

CI/CD管道

所有Pull Request将自动执行以下检查：

• 编码质量: ESLint静态分析
• 型安全性: TypeScript类型检查
• 测试：单体测试和集成测试
• 覆盖：80%以上的测试覆盖范围
• 安全性：相关性漏洞检查
• 格式: Prettier代码整形

你必须通过所有这些检查。

分支保护规则

main分支是受保护的，适用以下规则：

• Pull Request需要合并
• 需要一个或多个审核
• 所有状态检查必须通过
• 分支必须是最新的

详细的设置步骤是 来修改标记元素的显示属性。

📄 许可证

这个项目MIT 在许可证下公开。了解更多信息 许可证 请参见文件。

🙏 谢辞

• 模型上下文协议 -

MCP提供框架

• 人类克劳德密码 -提供开发环境

📞 支持

• 🐛 错误报告：

问题

• 💡 机能要望：

讨论

• 📖 详细仕样： CLAUDE.md

______________________________________________________________________

注意：此项目包括macOS是专用的。Windows屋脊Linux中所述修改相应参数的值。