================== /// MCP /// /// MCP /// ================== [server:online] [protocol:ready]
mcp-server-apple-reminders
by FradSer
MCP server that provides native integration with Apple Reminders on macOS.
96
13
Specialized01
create_reminder
Create a new reminder with a title and optional due date, list, note, or URL.
02
update_reminder
Update an existing reminder’s title, due date, note, completion status, list, or URL.
03
list_reminders
List reminders, optionally filtering by list, completion status, search text, or due-date range.
04
delete_reminder
Delete a reminder identified by its title, optionally specifying its list for accuracy.
05
move_reminder
Move a reminder from one list to another.
06
list_reminder_lists
Return all available reminder lists.
Installation
1. Prerequisites
• Node.js ≥ 18
• npm (comes with Node) or pnpm / yarn
• Apple iCloud account that has Reminders enabled
2. Clone or download the repository
git clone https://github.com/FradSer/mcp-server-apple-reminders.git
cd mcp-server-apple-reminders
3. Install dependencies
npm install # or pnpm install / yarn install
4. Build the TypeScript source (if the repo is shipped as TS)
npm run build # usually runs `tsc`
5. Configuration
Create a .env file (or export variables in your shell):
APPLE_ID="your_icloud_email@example.com"
APPLE_PASSWORD="your_app_specific_password"
MCP_PORT=8080 # port the server should listen on
MCP_AUTH_TOKEN="<token>" # optional bearer token to secure the endpoint
6. Start the MCP server
npm start # or `node dist/index.js`
7. Verify
curl http://localhost:8080/health # should return OK/200
8. Use inside your MCP-compatible client by pointing it to the running base-URL (e.g. http://localhost:8080).
Documentation
License: MIT License
Updated 7/30/2025