mcpField
M
Macbook Calendar Mcp Server

Macbook Calendar Mcp Server

本地服务
github.com/jayaprakashnarayana生产力029 周前更新

关于 Macbook Calendar Mcp Server

Macbook Calendar Mcp Server 将 MCP 客户端连接到 macOS 原生日历,并在本机处理日历数据。AI 模型可列出日历、按日期范围读取事件,并通过 AppleScript 创建事件。

主要功能

  1. 01列出可用日历
  2. 02按日期范围读取事件
  3. 03创建日历事件
  4. 04本地访问 macOS 日历
  5. 05遵循 macOS 权限控制

适用场景

  1. 01查看某个日期范围内的事件
  2. 02查找 Mac 上可用的日历
  3. 03创建包含地点和描述的事件

MCP 相关

该 MCP 服务提供列出日历、读取事件和在本地 macOS 日历中创建事件的工具。日历数据保留在设备上。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"mac-calendar": {
"command": "uvx",
"args": [
"mac-calendar-mcp"
]
}
}
}
启动命令uvx mac-calendar-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypimac-calendar-mcp

工具

6

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

Mac Calendar MCP 服务 📅

Mac Calendar MCP 服务是 Claude(或任何 MCP 客户端)与本地 macOS Calendar 应用之间的原生零依赖桥接工具。

与其他需要复杂 Google Cloud / OAuth 配置,或将你的私人 iCloud 数据暴露给第三方 Web API 的日历集成不同,此服务完全通过 macOS Apple Events 在本地通信。你的日历数据绝不会离开你的设备。


🔥 主要优势

  • 100% 本地且私密: 无需 iCloud 密码、OAuth 令牌或云中继。它会安全地读取 Mac 上的本地数据库。
  • 零配置: Mac 的 Calendar 应用中显示的所有日历(工作、家庭、已订阅的日历)都会立即提供给 Claude。
  • 高度安全的架构: 专为彻底防范提示词注入而设计。用户输入会严格作为 argv 参数传递,而不会插入脚本,从而消除任意代码执行的风险。
  • 原生 TCC 支持: 此服务遵循 macOS 的透明度、同意与控制机制。首次运行时,你必须手动授予 UI 权限,这意味着没有任何内容能在你不知情的情况下抓取日历。

🛠️ 内置工具

  1. list_calendars 快速获取 Mac 上当前可用的所有日历名称。
  2. get_events 获取指定日历在指定日期范围内的事件。它使用 ISO-8601 格式安全地标准化输入,避免因区域设置不同而导致时间戳崩溃。
  3. add_event 安全地创建新的日历事件,并将标题、开始和结束日期、地点及描述直接写入 Mac Calendar 应用。

🚀 快速设置(Claude Desktop)

无需复杂安装,只需将以下内容添加到 claude_desktop_config.json:

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

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。