AI导哈

日历管理服务

一个基于Model Context Protocol (MCP)的服务，提供AI助手自然语言访问Apple Calendar的功能，包括读取、搜索、创建和管理日历事件。

  • by andrewbergsma
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 andrewbergsma/apple-calendar-mcp

使用说明

苹果日历MCP服务器

一个全面的模型上下文协议（MCP）服务器，为AI助手提供对Apple日历的自然语言访问。内置于 FastMCP，此服务器允许直接通过Claude Desktop或其他MCP兼容客户端读取、搜索、创建和管理日历事件。

特性

阅读与列表

  • 日历概述：显示所有日历、今天的活动和下周的仪表板视图
  • 列出日历：查看所有包含事件计数的可用日历
  • 列出事件：从特定日历或日期范围浏览事件
  • 今日日程：快速查看当天的议程

搜索与分析

  • 高级搜索：多条件搜索（标题、位置、日期范围、与会者）
  • 寻找空闲时间：发现可用的时间安排
  • 冲突检测：检查重叠事件

事件创建

  • 创建事件：使用所有选项（位置、备注、与会者）创建完整的活动
  • 重复发生的事件：创建每日、每周、每月的重复事件
  • 快速添加：自然语言事件创建

活动管理

  • 更新事件：修改任何事件属性
  • 移动事件：将活动重新安排到新的时间
  • 删除事件：使用重复处理删除事件
  • 管理提醒：添加或修改事件警报

分析和导出

  • 统计：会议时间分析，繁忙时间细分
  • 出口：将事件导出为ICS、CSV或TXT格式

安装

先决条件

  • 已配置Apple日历的macOS
  • Python 3.7或更高版本
  • Claude Desktop或任何兼容MCP的客户端

快速开始

  1. 克隆存储库：
git clone https://github.com/andrewbergsma/apple-calendar-mcp.git
cd apple-calendar-mcp
  1. 创建并激活虚拟环境：
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  1. 配置Claude桌面(~/Library/Application Support/Claude/claude_desktop_config.json):
{
  "mcpServers": {
    "apple-calendar": {
      "command": "/path/to/apple-calendar-mcp/venv/bin/python3",
      "args": ["/path/to/apple-calendar-mcp/apple_calendar_mcp.py"]
    }
  }
}
  1. 重新启动克劳德桌面

使用示例

Show me my schedule for today
What meetings do I have this week?
Find a free 30-minute slot tomorrow afternoon
Create a meeting with John at 2pm on Friday
Move my 3pm meeting to 4pm
Search for all events about "project review"

许可证

MIT许可证-请参阅 许可证 了解详情。

致谢

相关 MCP