MCP Macos Calendar

mcp macos日历

用于macOS日历和提醒的原生Swift MCP服务器。让AI助手（Claude Desktop、OpenCode等）通过以下方式完全访问您的日历和提醒列表 EventKit 的.

完全用Swift编写 --没有桥，没有包装。直接使用苹果的EventKit框架，以获得最大的可靠性和性能。

特性

• 事件和提醒的完整CRUD
• 按文本搜索事件和提醒
• 便利工具： today, tomorrow, list_upcoming, complete_reminder
• 时间意识： get_current_time 工具和服务器指令，以便代理知道当前日期、时间和时区
• 批量操作（一次完成多个提醒）
• 重复规则（每日、每周、每月、每年，带高级选项）
• 与会者（只读）和可用性检查
• 多重报警支持
• 适用于所有日历源（iCloud、Exchange、Google、CalDAV、本地）
• 两种传输模式：stdio（用于克劳德桌面/OpenCode）和流式HTTP
• 用于浏览日历和资源的资源
• 严格的Swift 6并发

需求

• macOS 14.0（索诺玛）或更高版本
• 日历和提醒权限（首次运行时提示）

安装

预构建二进制文件（推荐）

从下载最新的通用二进制文件 :

# Download and extract the latest release
curl -L https://github.com/RodrigoCSoares/mcp-macos-calendar/releases/latest/download/mcp-macos-calendar-macos-universal.tar.gz | tar xz

# Move to a directory in your PATH
mv mcp-macos-calendar /usr/local/bin/

无需Xcode或Swift工具链。

薄荷

如果你有 薄荷 安装：

mint install RodrigoCSoares/mcp-macos-calendar

从源代码构建

需要Swift 6.0+（Xcode 16+）。

git clone https://github.com/RodrigoCSoares/mcp-macos-calendar.git
cd mcp-macos-calendar
swift build -c release

二进制文件将位于 .build/release/MCPMacOSCalendar.

设置

克劳德桌面版

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "calendar": {
      "command": "mcp-macos-calendar",
      "args": ["--transport", "stdio"]
    }
  }
}

如果二进制文件不在您的 PATH，请改用完整路径（例如。 /usr/local/bin/mcp-macos-calendar).

OpenCode

添加到您的OpenCode配置(~/.config/opencode/opencode.json):

{
  "mcp": {
    "calendar": {
      "type": "local",
      "command": ["mcp-macos-calendar", "--transport", "stdio"],
      "enabled": true
    }
  }
}

HTTP模式

对于支持Streamable HTTP传输的客户端：

mcp-macos-calendar --transport http --port 8080

MCP端点将在 http://127.0.0.1:8080/mcp.

权限

首次运行时，macOS会提示您授予日历和提醒访问权限。您还可以在中启用这些功能 系统设置>隐私和安全>日历 和 提醒事项.

如果您拒绝提醒访问，服务器仍将处理日历事件——提醒工具将返回错误。

工具

效用

事件

提醒事项

日历和来源

资源

CLI选项

USAGE: mcp-macos-calendar [--transport ] [--port 
] [--host ] [--log-level ]

OPTIONS:
  -t, --transport    Transport mode: stdio or http (default: stdio)
  -p, --port 
             HTTP port, only for http transport (default: 8080)
  --host                  HTTP host, only for http transport (default: 127.0.0.1)
  -l, --log-level    trace, debug, info, notice, warning, error, critical (default: info)
  --version                     Show the version
  -h, --help                    Show help information

路线图

• \[\]自制水龙头(brew install RodrigoCSoares/tap/mcp-macos-calendar)