Calendar Safe MCP

一个用于 Apple Calendar 的非官方本地 MCP 服务器。它使用 EventKit（Apple 支持的日历框架），从不直接读取日历数据库、账户凭据或 macOS 权限数据库。

需要 macOS 14 Sonoma 或更高版本，以及 Python 3.12 或更高版本。

它仅适用于 macOS，并提供四个工具：

• list_calendars

• list_events

• create_event

• update_event

安装

安装 uv，然后将服务器注册到你的 MCP 客户端。对于 Codex：

codex mcp add calendar -- uvx --from git+https://github.com/jasongibby/calendar-safe-mcp calendar-safe-mcp

对于其他 stdio MCP 客户端，使用：

{
  "mcpServers": {
    "calendar": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jasongibby/calendar-safe-mcp",
        "calendar-safe-mcp"
      ]
    }
  }
}

启动 MCP 客户端后调用 list_calendars。macOS 会请求为该客户端授予日历访问权限。在 系统设置 → 隐私与安全性 → 日历 中授予完全访问权限。

Related MCP server: calendar-mcp

安全与隐私

• 访问仅使用 Apple 的 EventKit 框架和正常的 macOS 同意流程。

• 除非传入 include_details=true，否则读取操作仅返回日程字段。

• 创建和更新的响应保持简洁，绝不回显备注、URL 或提醒。

• 除非传入 search_notes=true，否则文本查询仅搜索标题。

• 日期范围限制为 366 天，响应数量上限为 1,000。

• 对重复事件的更新需要显式指定 span 为 this 或 future。

• 服务器从不记录事件内容。

• 删除和创建重复事件的工具被有意省略。

你的 MCP 客户端和 AI 服务商可能看到服务器返回的日历数据。使用前请查看他们的隐私政策。本项目与 Apple 无关，亦未获得 Apple 认可。

参见 Apple 的 EventKit 文档。

开发

uv sync
uv run python -m unittest discover -s tests -v

测试使用 mock，不会访问日历数据。

许可证

MIT