AI导哈

日历提醒自动化工具

本地苹果日历和提醒事项自动化工具，提供Codex插件适配器和共享MCP层。

  • by mightymattys
  • Python
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 matk0shub/apple-productivity-mcp

使用说明

苹果生产力MCP

适用于macOS的本地Apple日历+提醒工具，带有Codex插件适配器和下面的共享MCP层。

这次回购给了你什么

  • 本机Apple日历自动化
  • 原生Apple提醒自动化
  • 可安装的Codex插件
  • 一个共享的本地MCP服务器
  • 重复事件和重复提醒
  • .ics 进出口
  • CLI和MCP流的烟雾测试

建筑

flowchart TD
    A["Codex User"] --> B["apple-calendar plugin"]
    A --> C["apple-reminders plugin"]
    B --> D["Shared MCP layer"]
    C --> D
    D --> E["Calendar EventKit backend"]
    D --> F["Reminders EventKit backend"]
    F --> G["AppleScript flag/unflag fallback"]

回购布局

apple-productivity-mcp/
  plugins/
    apple-calendar/          # user-facing Codex plugin
    apple-reminders/         # user-facing Codex plugin
  mcp/
    apple-productivity/      # shared MCP server layer
      server/
  scripts/
    install_local_plugins.py
    smoke_test_apple_cli.py
    smoke_test_apple_mcp.py
  .agents/plugins/marketplace.json
  CHANGELOG.md
  LICENSE
  README.md

什么是插件，什么是MCP？

plugins/

这些是您直接在Codex中安装和使用的东西。

  • apple-calendar
  • apple-reminders

它们包括：

  • 插件清单
  • 技能文档
  • CLI包装器
  • 配置
  • .mcp.json 连接到共享MCP服务器

mcp/

这是基础设施，而不是面向用户的插件层。

mcp/apple-productivity/ 包含两个插件使用的共享本地stdio MCP服务器。

这种分离使仓库更干净：

  • 插件UX保持不变 plugins/
  • 共享传输/集成逻辑保持不变 mcp/

选择您的使用模式

模式 最适合
Codex插件技能 Codex中自然聊天般的用法
CLI包装器 可脚本化的本地自动化
MCP工具 Codex和其他具有MCP功能的代理的可重用集成层

快速开始

  1. 在Mac上的任何位置克隆仓库。
  2. 运行：
/usr/bin/python3 scripts/install_local_plugins.py --repo-root "$(pwd)"

  1. 确保为以下项目启用了macOS权限：

    • 日历
    • 提醒事项

  2. 在Codex中打开仓库。

  3. 用途：

  • plugins/apple-calendar
  • plugins/apple-reminders

共享MCP层将自动布线。

冒烟测试

CLI：

/usr/bin/python3 scripts/smoke_test_apple_cli.py

MCP：

/usr/bin/python3 scripts/smoke_test_apple_mcp.py

这两个测试都会创建临时工件，并在之后对其进行清理。

亮点

苹果日历

  • 议程和免费窗口查找
  • 按标题+日期搜索
  • 创建、更新、删除
  • 提醒管理
  • 重复事件
  • .ics 进出口

Apple提醒

  • 到期、逾期和今日报警视图
  • 添加、更新、完成、重新打开、删除
  • 在列表之间移动
  • 定期提醒
  • 国旗和非国旗

文档

备注

  • 此repo适用于macOS。
  • 日历和提醒需要运行Codex的应用程序的系统权限。
  • 如果你以后想要另一个支持MCP的代理或未来的应用层，共享的MCP层是正确的基础。

释放卫生

组件

路径 目的
plugins/apple-calendar 日历插件层
plugins/apple-reminders 提醒插件层
mcp/apple-productivity 共享MCP服务器层
scripts/install_local_plugins.py 本地路径重写/安装帮助程序
scripts/smoke_test_apple_cli.py CLI烟雾测试
scripts/smoke_test_apple_mcp.py MCP烟雾测试

相关 MCP