영어 | 简体中文

EventKit 프레임워크를 통해 macOS에서 Apple Reminders 및 캘린더와 네이티브 통합을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 표준 인터페이스를 통해 리마인더, 리스트, 하위 작업 및 캘린더 이벤트를 완전한 CRUD 연산을 제공합니다.

EventKit 백엔드는 독립형 event Swift CLI로, git 서브모듈로 제공되어 pnpm install 동안 bin/event에 내장되어 별도의 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