Apple Reminders MCP
A tool that enables creating and querying Apple Reminders through natural language, allowing users to set reminder content (title and notes) and specify reminder date/time.
README
苹果提醒事项 MCP 工具使用说明
这个工具基于小智AI的MCP功能进行开发(开发示例文档见：mcp-calculator)，允许通过 MCP 协议创建和查询苹果提醒事项，可以设置提醒内容（标题和备注）以及提醒日期时间。
功能特点
创建提醒事项
- 设置提醒标题（必填）
- 添加提醒备注（选填）
- 设置提醒日期（选填，格式：YYYY-MM-DD）
- 设置提醒时间（选填，格式：HH:MM:SS，需要提供日期才有效）
查询提醒事项
- 按日期范围查询提醒事项（如"今天"、"明天"、"本周"等）
- 获取提醒事项的完整信息（标题、备注、日期时间）
- 支持自然语言日期表达（如"今天"、"明天"、"周五"等）
安装与配置
- 确保已安装所需依赖：
pip install -r requirements.txt
- 设置环境变量：
export MCP_ENDPOINT=<your_mcp_endpoint>
使用方法
1. 启动 MCP 服务器
使用 mcp_pipe.py 启动提醒事项服务器：
python mcp_pipe.py reminder.py
2. 通过 AI 助手使用提醒事项工具
一旦服务器启动并连接到 AI 助手，您可以通过自然语言使用提醒事项工具：
创建提醒事项
- "帮我创建一个提醒事项，标题是'买牛奶'，备注是'超市特价'，日期是明天"
- "设置一个提醒，标题是'医生预约'，日期是2025年5月20日，时间是下午3点"
- "添加一个提醒：周五下午2:30开会"
查询提醒事项
- "查询我今天的提醒事项"
- "明天有哪些提醒事项？"
- "列出本周的所有提醒"
- "查看5月20日的提醒事项"
- "周五有什么提醒？"
测试工具
测试创建提醒事项
您可以使用提供的测试脚本来测试提醒事项创建功能：
python test_reminder.py
测试查询提醒事项
您可以使用提供的测试脚本来测试提醒事项查询功能：
python test_get_reminders.py
创建提醒事项的测试脚本将运行几个测试用例，包括：
- 创建没有日期的提醒事项
- 创建只有日期的提醒事项
- 创建有日期和时间的提醒事项
查询提醒事项的测试脚本将运行以下测试用例：
- 查询今天的提醒事项
- 查询明天的提醒事项
- 查询本周的提醒事项
故障排除
常见问题
-
权限问题：确保您的应用有权限访问提醒事项。首次运行时可能会弹出权限请求对话框。
-
日期格式错误：确保日期格式为 YYYY-MM-DD（例如 2025-05-18）。
-
时间格式错误：确保时间格式为 HH:MM:SS（例如 14:30:00）。
调试
如果遇到问题，可以查看日志输出以获取更多信息。日志会显示在终端中。
功能测试
在真机上测试此功能时，请注意以下几点：
-
基本功能测试：
- 创建不同类型的提醒事项（无日期、有日期、有日期和时间）
- 验证提醒事项是否正确显示在苹果提醒事项应用中
-
边界情况测试：
- 测试特殊字符在标题和备注中的处理
- 测试过去的日期和时间
- 测试无效的日期和时间格式
-
错误处理测试：
- 测试缺少必填参数（标题）的情况
- 测试提供时间但不提供日期的情况
进一步改进
未来可能的改进方向：
- 支持重复提醒（每天、每周、每月等）
- 支持设置提醒优先级
- 支持添加到特定提醒事项列表
- 支持设置位置提醒
- 支持查询和修改现有提醒事项
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.