Atlas / MCP servers / fradser / Apple Events

Apple EventsBLOCK

mcp/fradser/apple-events

MCP server providing native macOS integration with Apple Reminders and Calendar via EventKit

Verdict
BLOCK
Grade
D
Trust score
69 /100
Exposed tools
9 8r · 1w · 0d
Transport
stdio
License
MIT
Stars
216
01

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
Read from source at commit 985fa0521da3OBSERVED · 2026-10-06
02

Connect

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-code
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]
claude-desktop
{
  "mcpServers": {
    "mcp-server-apple-events": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "APPLE_APP_PASSWORD": "${APPLE_APP_PASSWORD}",
        "ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
      }
    }
  }
}
03

Exposed tools (9)

8 read · 1 write · 0 destructive.

ToolRiskDescription
calendar_calendarsreadReads calendar collections
calendar_eventsreadManages calendar events
daily-task-organizerreadProactive daily task organization with intelligent reminder creation and optimization
reminder-review-assistantreadAnalyze and review existing reminders for productivity optimization
reminders_listsreadManages reminder lists
reminders_subtasksreadManages 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_tasksreadManages reminder tasks
smart-reminder-creatorwriteIntelligently create reminders with optimal scheduling and context
weekly-planning-workflowreadAssign due dates to existing reminders based on your weekly planning ideas
04

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.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codeFAIL
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (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)

HIGHPrivilege escalation / persistence · priv.escalate · CWE-269, CWE-250
scripts/build-event.mjs:86
'       sudo softwareupdate -i "Command Line Tools for Xcode-<latest>"',
Why it matters. asks for elevated privileges
HIGHPrivilege escalation / persistence · priv.escalate · CWE-269, CWE-250
scripts/build-event.mjs:89
'       sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer',
Why it matters. asks for elevated privileges
LOWInventory / provenance · inv.hidden_file · CWE-1104
.gitmodules
.gitmodules
Why it matters. hidden member outside the usual dotfiles
Fix. review its purpose
LOWFilesystem / path · fs.system_paths · CWE-22, CWE-59
src/utils/binaryValidator.test.ts:114
const binaryPath = '/usr/local/bin/malicious';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/handlers/calendarHandlers.ts:11
} from '../../types/index.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/handlers/calendarHandlers.ts:12
import { calendarRepository } from '../../utils/calendarRepository.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/handlers/calendarHandlers.ts:16
} from '../../utils/errorHandling.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/handlers/calendarHandlers.ts:17
import { formatMultilineNotes } from '../../utils/helpers.js';
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/handlers/calendarHandlers.ts:24
} from '../../validation/schemas.js';
LOWNetwork egress · net.metadata_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-design/bdd-specs.md:123
Given a user provides url="http://169.254.169.254/latest/meta-data/"
Why it matters. cloud metadata endpoint: the classic SSRF credential grab
LOWNetwork egress · net.metadata_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-design/best-practices.md:31
| AWS | `169.254.169.254` | Explicit IP block |
Why it matters. cloud metadata endpoint: the classic SSRF credential grab
LOWNetwork egress · net.metadata_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-design/best-practices.md:32
| Azure | `169.254.169.254` | Explicit IP block |
Why it matters. cloud metadata endpoint: the classic SSRF credential grab
LOWNetwork egress · net.metadata_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-design/best-practices.md:33
| GCP | `metadata.google.internal` | Explicit host block |
Why it matters. cloud metadata endpoint: the classic SSRF credential grab
LOWNetwork egress · net.metadata_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-plan/task-003-ssrf-url-validation-impl.md:48
- `169.254.169.254` (AWS/Azure)
Why it matters. cloud metadata endpoint: the classic SSRF credential grab
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-design/bdd-specs.md:107
Given a user provides url="http://127.0.0.1/admin"
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-design/bdd-specs.md:123
Given a user provides url="http://169.254.169.254/latest/meta-data/"
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-design/bdd-specs.md:131
Given a user provides url="http://169.254.1.1/resource"
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-plan/task-003-ssrf-url-validation-test.md:13
Given a user provides url="http://127.0.0.1/admin"
LOWNetwork egress · net.raw_ip · CWE-200, CWE-319
docs/plans/2026-02-27-code-review-fixes-plan/task-003-ssrf-url-validation-test.md:23
Given a user provides url="http://169.254.169.254/latest/meta-data/"
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@modelcontextprotocol/sdk, exit-on-epipe, zod, @swc/core, @swc/jest, @types/jest, @types/node, jest
Why it matters. 9 dependency range(s) float
Fix. pin exact versions or ship a lockfile
LOWPrompt injection · prompt.transfer_instruction · CWE-94, CWE-1427
docs/plans/2026-08-23-calendar-attendees-plan/task-004-applescript-attendees-impl.md:45
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
Why it matters. an instruction to move sensitive data to an outside destination
Fix. remove; a skill never needs the user's secrets off the machine
INFOPrompt injection · prompt.authority_framing · CWE-94, CWE-1427
CHANGELOG.md:198
- Full access permission errors for calendar operations
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
README.md:247
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
Why it matters. asks the agent to read credentials
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
docs/plans/2026-08-23-calendar-attendees-design/_index.md:152
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
Why it matters. asks the agent to read credentials
INFOPrompt injection · prompt.credential_read · CWE-94, CWE-1427
docs/plans/2026-08-23-calendar-attendees-design/bdd-specs.md:421
Then the password is read from the Keychain service icloud-caldav-mcp
Why it matters. asks the agent to read credentials

Gates applied: no_behavioural_pass.

Audited 2026-10-06 · audit v0.4.1 · source sha 985fa0521da3full audit observations/trust-audit/mcp-server/fradser__apple-events.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-06985fa0521da3BLOCKD69first audit
06

Questions

What is the Apple Events MCP server?

MCP server providing native macOS integration with Apple Reminders and Calendar via EventKit

What tools does Apple Events 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 Events 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 Events 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 Events 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-06. The repository is watched and re-audited when it changes.

Advertisement