mcpField
M
Mac Calendar MCP

Mac Calendar MCP

本地服务
github.com/wagamama生产力015 周前更新
代码仓库

关于 Mac Calendar MCP

Mac Calendar MCP 是面向助手的只读 macOS 日历 MCP 服务，通过本地索引搜索日历归档，并可在运行时监视数据变化以刷新索引。

主要功能

  1. 01只读访问 Mac 日历
  2. 02建立本地索引并搜索归档
  3. 03监视数据库变化并刷新索引
  4. 04配置索引范围与工具默认值

适用场景

  1. 01搜索本地日历归档
  2. 02让 MCP 客户端读取日历数据
  3. 03持续更新日历搜索索引

MCP 相关

作为 MCP 服务，它向 MCP 客户端提供本地日历数据的只读访问与索引搜索。支持在服务运行期间同步并刷新索引。

配置

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

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

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

安装包
pypimac-calendar-mcp0.5.15

工具

6

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

此工具无需参数。

详细介绍

Apple App MCP

为 MCP 服务提供的工作区，这些服务会向助手公开本地 Apple 应用数据。

软件包

软件包状态用途
mac-mail-mcpBetaMac Mail MCP 服务，优先从磁盘读取，并支持全面覆盖的 FTS5 正文搜索。
mac-calendar-mcpAlpha只读 Mac Calendar MCP 服务，支持索引归档搜索。

快速入门

安装所需的软件包：

pipx install mac-mail-mcp
pipx install mac-calendar-mcp

构建本地索引以加快搜索：

mac-mail-mcp index --verbose
mac-calendar-mcp authorize
mac-calendar-mcp index

Calendar 授权会安装一个小型辅助应用，它具有稳定的 macOS 隐私身份。请批准一次其“完全访问日历”提示，这样终端、MCP 和计划的 launchd 重建任务都能一致地使用 EventKit。EventKit 会在该已签名应用的身份下运行；Calendar MCP 不会通过匿名的 osascript 进程执行辅助应用脚本。

生成可选配置文件：

mac-mail-mcp init
mac-calendar-mcp init

索引范围与工具默认值分别配置。使用 [index] 设置（例如 Mail 的 accounts 或 Calendar 的 calendars）来控制本地存储的内容；使用 [defaults] 设置来控制调用方未指定范围时 MCP 工具使用的范围。

Codex CLI

注册一个或两个服务：

codex mcp add mail -- mac-mail-mcp serve --watch
codex mcp add calendar -- mac-calendar-mcp serve --watch

确认注册：

codex mcp list
codex mcp get mail
codex mcp get calendar
Claude Code

在项目根目录中创建或编辑 .mcp.json：

{
  "mcpServers": {
    "mail": {
      "command": "mac-mail-mcp",
      "args": ["serve", "--watch"]
    },
    "calendar": {
      "command": "mac-calendar-mcp",
      "args": ["serve", "--watch"]
    }
  }
}

在 MCP 服务运行期间，监视模式会让索引保持最新。Mail 使用文件监视；Calendar 会在启动时同步，随后在 Calendar 的本地 SQLite 数据库文件发生变化时刷新。

对于 Claude Code 全局配置，将相同的 mcpServers 对象放入 ~/.claude/mcp.json。

开发

此仓库采用 uv 工作区结构。每个 MCP 服务都位于 packages/ 下，并拥有自己的软件包元数据、源代码、测试和 README。

git clone https://github.com/wagamama/apple-app-mcp
cd apple-app-mcp
uv sync

# All packages
uv run ruff check packages/mac-mail-mcp/src packages/mac-calendar-mcp/src
uv run pytest

# Individual packages
uv run --package mac-mail-mcp pytest packages/mac-mail-mcp/tests
uv run --package mac-calendar-mcp pytest packages/mac-calendar-mcp/tests

构建分发包：

uv build --package mac-mail-mcp
uv build --package mac-calendar-mcp

文档

文档通过 GitHub Pages 从 .github/workflows/docs.yml 部署。仓库必须在 Settings -> Pages -> Build and deployment -> Source: GitHub Actions 中配置一次 Pages。工作流会部署构建好的产物；它不会尝试创建或启用 Pages 站点，因为 GitHub 在某些仓库中会拒绝默认工作流令牌执行此操作。

致谢

此代码库源自 imdinu/apple-mail-mcp。感谢原作者和贡献者提供 Apple Mail MCP 基础，本仓库正是在此基础上构建而成。

许可证

GPL-3.0-or-later

评论

支持 Markdown

第一次接触 MCP？

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

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