Английский | 简体中文

Сервер Model Context Protocol (MCP), обеспечивающий нативную интеграцию с Apple Reminders и Calendar на macOS через фреймворк EventKit. Предоставляет напоминания, списки, подзадачи и события календаря через стандартизированный интерфейс с полными операциями CRUD.

Бэкенд EventKit — это автономный event Swift CLI, разработанный как git-подмодуль и встроенный в bin/event во время pnpm install — отдельный brew install не требуется. См. docs/migration-to-event-cli.md для замены бэкенда v1.5.0 и списка полей записи, которые ещё не были открыты в event.

Содержание

• Особенности
• Предварительные требования
• Быстрый старт
• Конфигурация
• Права на 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