Apple RemindersBLOCK
MCP server providing native macOS integration with Apple Reminders and Calendar via EventKit
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Apple Events MCP Server
[](https://x.com/FradSer)
English | 简体中文
A Model Context Protocol (MCP) server providing native integration with Apple Reminders and Calendar on macOS via the EventKit framework. Exposes reminders, lists, subtasks, and calendar events through a standardized interface with full CRUD operations.
The EventKit backend is the standalone `event` Swift CLI, vendored as a git submodule and built into bin/event during pnpm install — no separate brew install required. See docs/migration-to-event-cli.md for the v1.5.0 backend swap and the list of write fields not yet exposed by event.
Table of Contents
- Features
- Prerequisites
- Quick Start
- Configuration
- macOS Permissions
- Usage Examples
- Available MCP Tools
- Structured Prompt Library
- Development
- License
- Contributing
Features
- Full CRUD for reminders, subtasks, reminder lists, and calendar events
- Priority (high/medium/low/none), tags, and checklist subtasks with progress tracking
- Multi-criteria filtering: completion, due-date range, priority, tags, full-text search, recurring, location-based
- Flexible date formats (
YYYY-MM-DD,YYYY-MM-DD HH:mm:ss, ISO 8601) with timezone awareness - Native macOS integration via EventKit — values configured in Reminders.app / Calendar.app round-trip through read responses
- Automatic macOS permission discovery and prompting
- Full Unicode support with comprehensive input validation
Prerequisites
- Node.js 20 or later
- macOS
985fa0521da3OBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add mcp-server-apple-events --env APPLE_APP_PASSWORD=${APPLE_APP_PASSWORD} --env ICLOUD_APP_PASSWORD=${ICLOUD_APP_PASSWORD} -- npx -y [email protected]{
"mcpServers": {
"mcp-server-apple-events": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"APPLE_APP_PASSWORD": "${APPLE_APP_PASSWORD}",
"ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
}
}
}
}Exposed tools (9)
8 read · 1 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
calendar_calendars | read | Reads calendar collections |
calendar_events | read | Manages calendar events |
daily-task-organizer | read | Proactive daily task organization with intelligent reminder creation and optimization |
reminder-review-assistant | read | Analyze and review existing reminders for productivity optimization |
reminders_lists | read | Manages reminder lists |
reminders_subtasks | read | Manages subtasks/checklists within reminders. Subtasks are stored in the notes field and visible in the native Reminders app. Use this to create checklist items for a reminder. |
reminders_tasks | read | Manages reminder tasks |
smart-reminder-creator | write | Intelligently create reminders with optimal scheduling and context |
weekly-planning-workflow | read | Assign due dates to existing reminders based on your weekly planning ideas |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (8 observation(s))
- Network
- declared (1 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (25)
' sudo softwareupdate -i "Command Line Tools for Xcode-<latest>"',
' sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer',
.gitmodules
const binaryPath = '/usr/local/bin/malicious';
} from '../../types/index.js';
import { calendarRepository } from '../../utils/calendarRepository.js';} from '../../utils/errorHandling.js';
import { formatMultilineNotes } from '../../utils/helpers.js';} from '../../validation/schemas.js';
Given a user provides url="http://169.254.169.254/latest/meta-data/"
| AWS | `169.254.169.254` | Explicit IP block |
| Azure | `169.254.169.254` | Explicit IP block |
| GCP | `metadata.google.internal` | Explicit host block |
- `169.254.169.254` (AWS/Azure)
Given a user provides url="http://127.0.0.1/admin"
Given a user provides url="http://169.254.169.254/latest/meta-data/"
Given a user provides url="http://169.254.1.1/resource"
Given a user provides url="http://127.0.0.1/admin"
Given a user provides url="http://169.254.169.254/latest/meta-data/"
@modelcontextprotocol/sdk, exit-on-epipe, zod, @swc/core, @swc/jest, @types/jest, @types/node, jest
3. Record the trade-off accepted: this requires Calendar.app and a TCC Automation grant, so it is unsuitable for headless contexts. It buys the absence of any credential and, more importantly, lets Ca
- Full access permission errors for calendar operations
Use an [app-specific password](https://support.apple.com/en-us/102654), never your account password. Credentials are read from the environment first, then the Keychain, never from MCP client config, a
The Keychain read shells `security find-generic-password` against the service `icloud-caldav-mcp`. The password is returned to the caller and never logged, never embedded in an error, and never writte
Then the password is read from the Keychain service icloud-caldav-mcp
Gates applied: no_behavioural_pass.
985fa0521da3full audit observations/trust-audit/mcp-server/fradser__apple-reminders-1.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | 985fa0521da3 | BLOCK | D | 69 | first audit |
Questions
What is the Apple Reminders MCP server?
MCP server providing native macOS integration with Apple Reminders and Calendar via EventKit
What tools does Apple Reminders expose?
9 in total: 8 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Apple Reminders safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 2 critical or high issues in the source. Each one is listed on this page with the file and line it is on.
What credentials does Apple Reminders need?
It reads APPLE_APP_PASSWORD and ICLOUD_APP_PASSWORD from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Apple Reminders run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as mcp-server-apple-events at 1.5.0.
How current is this page?
The grade is for one exact copy of the source (985fa0521da3), read on 2026-10-07. The repository is watched and re-audited when it changes.