英語 |简体中文

EventKitフレームワークを通じてmacOS上のApple Remindersおよびカレンダーとネイティブに統合するModel Context Protocol(MCP)サーバーです。標準化されたインターフェースを通じてリマインダー、リスト、サブタスク、カレンダーイベントを公開し、完全なCRUD操作を備えています。

EventKitのバックエンドはスタンドアロンのeventSwift CLIで、gitサブモジュールとして販売され、pnpm install中に組み込まれています。別々のbrew installは不要です。v1.5.0バックエンドの交換や、eventでまだ公開されていない書き込みフィールドのリストについてはdocs/migration-to-event-cli.mdを参照してください。

目次

• 特徴
• 前提条件
• クイックスタート
• 構成
• macOS権限
• 使用例
• 書き込み確認および信頼できないデータの
• 利用可能なMCPツール
• 構造化プロンプトライブラリ
• 開発
• ライセンス
• 貢献

特徴

• リマインダー、サブタスク、リマインダーリスト、カレンダーイベントのためのフルCRUD
• 優先度(高/中/低/なし)、タグ、進捗追跡付きのチェックリストサブタスク
• マルチクライミクスフィルタリング:完了、期限範囲、優先度、タグ、全文検索、繰り返し検索、位置情報に基づく
• 柔軟な日付フォーマット(YYYY-MM-DD、YYYY-MM-DD HH:mm:ss、ISO 8601)とタイムゾーン認識機能

Apple Events MCP Server

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
• Write confirmation and untrusted data
• 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 (required for EventKit)
• Xcode Command Line Tools (only when building from source)
• pnpm (recommended)

The published npm package ships a pre-built, universal, code-signed bin/event binary, so npx users need neither Xcode nor a Swift toolchain. Building from a git clone requires the items above.

Quick Start

npx mcp-server-apple-events

Configuration

Add the server to your MCP client. The npx form works for every client below; for a local build, replace command/args with node pointing at dist/index.js.

Cursor

Settings → MCP → Add new global MCP server:

{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": ["-y", "mcp-server-apple-events"]
    }
  }
}

ChatWise

Settings → Tools → “+”, then:

• Type: stdio
• ID: apple-reminders
• Command: mcp-server-apple-events
• Args: (empty)

Claude Desktop