Skip to main content
Glama

MCP Apple Reminders

by shadowfax92
README.md2.49 kB
# 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`: ```json { "mcpServers": { "apple-reminders": { "command": "node", "args": [ "/path/to/mcp-apple-reminders/dist/index.js" ] } } } ``` ### NPX (Coming Soon) ```json { "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 list - `title` (required): The title of the reminder - `dueDate` (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 list - `reminderName` (required): The name of the reminder to complete ### deleteReminder Deletes a reminder. - Parameters: - `listName` (required): The name of the reminder list - `reminderName` (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

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/shadowfax92/apple-reminders-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server