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/

选择您的使用模式

快速开始

1. 在Mac上的任何位置克隆仓库。
2. 运行：

/usr/bin/python3 scripts/install_local_plugins.py --repo-root "$(pwd)"

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

- 日历 - 提醒事项

1. 在Codex中打开仓库。

1. 用途：

• 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层是正确的基础。

释放卫生

• 更改日志.md
• 许可证

组件