# Apple Productivity

> Codex plugin and workflows for Apple Calendar, Reminders, and Notes on macOS.

- **Type:** MCP server
- **Install:** `agentstack add mcp-kaleljl-apple-productivity`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [KaleLjl](https://agentstack.voostack.com/s/kaleljl)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [KaleLjl](https://github.com/KaleLjl)
- **Source:** https://github.com/KaleLjl/apple-productivity

## Install

```sh
agentstack add mcp-kaleljl-apple-productivity
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Apple Productivity

一个面向 Codex 的 macOS 原生生产力插件，把 Apple Calendar、Reminders 和 Notes 串成统一、可审计的工作流。

> Apple Productivity 是独立的开源项目，与 Apple Inc. 不存在隶属、赞助或背书关系。Apple、macOS、Calendar、Reminders 和 Notes 是其各自权利人的商标。

## 能做什么

- 查看和管理日历事件、提醒事项与 Apple Notes
- 生成每日或每周回顾，标记冲突、逾期任务和空闲时间
- 从笔记中提取行动项并转成提醒
- 汇总会议日程、相关笔记和待办，生成会前准备或会后跟进
- 在 Notes 中创建基础富文本内容
- 对修改、删除、重复日程、共享笔记和附件提供安全保护

## 仓库结构

```text
.
├── .agents/plugins/marketplace.json
├── plugins/apple-productivity/
│   ├── .codex-plugin/plugin.json
│   ├── .mcp.json
│   └── skills/apple-productivity/
│       ├── SKILL.md
│       ├── agents/openai.yaml
│       ├── references/
│       └── scripts/
├── docs/
└── scripts/validate_repo.py
```

## 依赖

- macOS
- Node.js 与 `npx`
- Codex 插件支持
- `mcp-server-apple-events@1.4.0`
- `apple-notes-mcp@2.5.12`

MCP 依赖通过 `npx` 在首次使用时安装，不会提交到本仓库。更新依赖版本前，请分别验证 Calendar、Reminders 和 Notes 的读写流程。

## 本地安装

克隆仓库后，将仓库根目录注册为本地 marketplace：

```bash
codex plugin marketplace add /absolute/path/to/apple-productivity
codex plugin add apple-productivity@apple-productivity
```

安装后新建一个 Codex 任务，使技能和 MCP 工具重新加载。macOS 第一次访问时会分别请求 Calendar、Reminders 和 Notes 权限。

## 示例

- “看看我今天下午有什么日程和到期工作。”
- “把‘产品讨论’笔记里的行动项整理成提醒，先给我预览。”
- “结合日历、笔记和待办，帮我准备下一场会议。”
- “在 iCloud 的 Notes 文件夹中创建一篇带标题和列表的富文本笔记。”

## 权限故障

正常情况下，只需在 **系统设置 → 隐私与安全性** 中允许 Calendar、Reminders 和 Notes 访问。

若 `mcp-server-apple-events` 始终返回拒绝、系统设置中也没有出现请求方，可先执行只读诊断：

```bash
python3 plugins/apple-productivity/skills/apple-productivity/scripts/repair_eventkit_permissions.py
```

确认检测路径无误并明确同意修改本地连接器后，再加 `--apply`。脚本会备份原桥接程序，只重置自己的权限记录，不会清除其他应用的 Calendar 或 Reminders 授权。

## 开发与验证

```bash
python3 scripts/validate_repo.py
```

发布前还应使用 Codex 自带的 skill 和 plugin validator。完整流程见 [docs/releasing.md](docs/releasing.md)。

## 维护原则

- MCP 依赖使用精确版本，升级通过独立 PR 完成。
- 所有写操作必须在完成后重新读取验证。
- 高影响操作需要预览和确认。
- 不读取与当前请求无关的笔记正文。
- 不绕过 macOS 隐私控制。

## 许可证

本仓库使用 MIT License。第三方 MCP 依赖并未被复制进仓库，使用时同时受各自许可证约束。

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [KaleLjl](https://github.com/KaleLjl)
- **Source:** [KaleLjl/apple-productivity](https://github.com/KaleLjl/apple-productivity)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-kaleljl-apple-productivity
- Seller: https://agentstack.voostack.com/s/kaleljl
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.