Calendar App MCP
2025.04.19
0
Python日历服务AI 助手集成日程管理
Calendar App MCP 是一个基于 MCP（Model Context Protocol）协议的服务器，用于提供对 macOS Calendar.app 事件和提醒的访问，以便与 Claude 和其他 AI 助手集成使用。该服务允许 AI 助手查看、搜索和管理用户的日历数据，包括事件、提醒、日历列表等。
View on GitHub
Overview
基本能力
产品定位
Calendar App MCP 是一个用于与 macOS 日历数据交互的 MCP 服务器，旨在为 AI 助手提供日历数据的访问和管理能力。
核心功能
- 访问 macOS Calendar.app 的事件和提醒
- 按日期范围、日历名称和全天/忙碌状态进行筛选
- 支持 JSON 或 Markdown 格式输出
- 提供安全的本地日历数据访问
适用场景
- AI 助手查询用户的日程安排
- 查找空闲时间段
- 查看事件详情
- 访问提醒事项
- 按日历、日期范围等条件筛选事件
工具列表
get_events: 检索特定日期范围内的事件get_reminders: 检索特定日期范围内的提醒list_calendars: 列出所有可用日历get_today_summary: 获取当天事件和提醒的摘要search: 搜索包含特定术语的事件和提醒get_current_time: 获取任何时区的当前日期和时间convert_time: 将时间从一个时区转换到另一个时区list_timezones: 列出可用时区，可按区域筛选
常见问题解答
- 如何运行 MCP 服务器？
bash uvx calendar-app-mcp # 自动以 MCP 服务器模式运行 uvx calendar-app-mcp mcp # 显式运行 MCP 服务器 - 如何安装开发版本？
bash git clone https://github.com/rygwdn/calendar-app-mcp.git cd calendar-app-mcp uv install -e .
使用教程
使用依赖
无特殊依赖，可直接安装。
安装教程
# 从 PyPI 安装
pip install calendar-app-mcp
# 使用 uv 安装
uv pip install calendar-app-mcp
# 使用 uvx 直接运行（无需安装）
uvx calendar-app-mcp calendars
uvx calendar-app-mcp mcp
调试方式
# 列出可用日历
uvx calendar-app-mcp calendars
# 获取今天的事件和提醒
uvx calendar-app-mcp today
# 仅获取事件
uvx calendar-app-mcp events
# 仅获取提醒
uvx calendar-app-mcp reminders
# 获取事件和提醒
uvx calendar-app-mcp all
# 显示 JSON 架构
uvx calendar-app-mcp schema
# 检查版本
uvx calendar-app-mcp --version