About Apple Reminders MCP
Apple Reminders MCP is an MCP server published by shadowfax92 in the Other category.
The repository has 39 stars and 12 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/shadowfax92/apple-reminders-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Apple Reminders MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 2 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
README
MCP Apple Reminders
A Model Context Protocol (MCP) server for interacting with Apple Reminders on macOS.
Features
- List Management: View all reminder lists in your Apple Reminders app
- Reminder Retrieval: Get all reminders from a specific list
- Create Reminders: Create new reminders with titles, due dates, and notes
- Complete Reminders: Mark reminders as completed
- Delete Reminders: Remove reminders from your lists
- Date Handling: Proper handling of ISO date formats for due dates
Configuration
Usage with Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"apple-reminders": {
"command": "node",
"args": [
"/path/to/mcp-apple-reminders/dist/index.js"
]
}
}
}
NPX (Coming Soon)
{
"mcpServers": {
"apple-reminders": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-apple-reminders"
]
}
}
}
API
The server exposes the following MCP tools for interacting with Apple Reminders:
getLists
Returns all reminder lists.
getReminders
Returns reminders from a specific list.
- Parameters:
listName(required): The name of the reminder list
createReminder
Creates a new reminder.
- Parameters:
listName(required): The name of the reminder listtitle(required): The title of the reminderdueDate(optional): The due date for the reminder (ISO format: "YYYY-MM-DDTHH:MM:SS.sssZ")notes(optional): Notes for the reminder
completeReminder
Marks a reminder as completed.
- Parameters:
listName(required): The name of the reminder listreminderName(required): The name of the reminder to complete
deleteReminder
Deletes a reminder.
- Parameters:
listName(required): The name of the reminder listreminderName(required): The name of the reminder to delete
How It Works
This MCP server uses AppleScript to interact with the Apple Reminders app on macOS. It provides a standardized interface for AI assistants to manage reminders through the Model Context Protocol.
Development
This project uses TypeScript and the MCP SDK. To extend functionality, modify the tools in src/index.ts and the AppleScript functions in src/reminders.ts.
Requirements
- macOS (required for Apple Reminders integration)
- Node.js 16+
- Apple Reminders app configured with at least one list
License
MIT
README fetched from the repository 2 days ago. The original is authoritative.