AI导哈

苹果日历交互服务

通过AppleScript与macOS上的Apple Calendar进行交互的MCP服务器，支持列出日历、搜索事件、创建和删除事件等功能。

  • by ipalseb-dev
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 IPalSeb/mcp-apple-calendar

使用说明

mcp苹果日历

MCP服务器，用于通过AppleScript在macOS上与Apple日历进行交互。

需求

  • macOS（使用AppleScript与Calendar.app通信）
  • Node.js>=18

安装

使用npx（推荐）

无需安装。直接在MCP客户端中配置：

{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "npx",
      "args": ["-y", "mcp-apple-calendar"]
    }
  }
}

来源

git clone https://github.com/IPalSeb/mcp-apple-calendar.git
cd mcp-apple-calendar
npm install
npm run build

然后配置：

{
  "mcpServers": {
    "mcp-apple-calendar": {
      "command": "node",
      "args": ["/path/to/mcp-apple-calendar/dist/index.js"]
    }
  }
}

工具

list_calendars

列出所有可用日历。

参数：无

list_events

列出日期范围内的事件。

参数 类型 必填 说明
start string yes ISO格式的开始日期（例如。 2026-01-30)
end string yes ISO格式的结束日期（例如。 2026-02-06)
calendar string 否 按日历名称筛选

search_events

按标题文本搜索事件。

参数 类型 必填 说明
query string yes 要在事件标题中搜索的文本
calendar string 否 按日历名称筛选
limit number no 最大结果数（默认值20）

create_event

创建新事件。

参数 类型 必填 说明
title string 是 事件标题
start string yes 以ISO格式开始日期时间
end string yes 结束ISO格式的日期时间
calendar string yes 日历名称
location string 否 事件位置
description string 否 事件描述
allDay boolean no 全天事件（默认为false）

delete_event

按确切标题删除事件。

参数 类型 必填 说明
title string yes 确切的事件标题
calendar string yes 日历名称

权限

首次使用时，macOS会要求您授予运行服务器的终端应用程序（终端、iTerm2等）的日历访问权限。你必须允许这些工具工作。

许可证

麻省理工学院

相关 MCP