che-ical-mcp

macOS Calendar & Reminders MCP server - Native EventKit integration for complete calendar and task management.

English | 繁體中文

---

⚠️ Claude Desktop .mcpb install is temporarily broken (2026-05-12)

The .mcpb extension install for Claude Desktop cannot write to Calendar / Reminders on Claude Desktop 1.6608.2 and later (released ~2026-05-09). Write tools return Calendar access denied; read tools still work.

Use one of these instead until Anthropic ships a fix:

Path	Status
Claude Code plugin (claude plugin install che-ical-mcp@psychquant-claude-plugins)	✓ Works
Legacy claude_desktop_config.json (point Claude Desktop at the binary directly)	⚠ Untested, may bypass the broken wrapper
Google Calendar API + manual move to target calendar	✓ Works

Tracking: upstream anthropics/claude-code#58239, local #132. Detailed evidence + structural diagnosis in those threads. This banner will be removed once Anthropic restores .mcpb Calendar access.

---

Why che-ical-mcp?

Feature	Other Calendar MCPs	che-ical-mcp
Calendar Events	Yes	Yes
Reminders/Tasks	No	Yes
Reminder #Tags	No	Yes (MCP-level)
Multi-keyword Search	No	Yes
Duplicate Detection	No	Yes
Conflict Detection	No	Yes
Batch Operations	No	Yes
Local Timezone	No	Yes
Source Disambiguation	No	Yes
Create Calendar	Some	Yes
Delete Calendar	Some	Yes
Event Reminders	Some	Yes
Location & URL	Some	Yes
Language	Python	Swift (Native)

---

Quick Start

For Claude Desktop

Option A: MCPB One-Click Install (Recommended)

Download the latest .mcpb file from Releases and double-click to install.

Option B: Manual Configuration

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "che-ical-mcp": {
      "command": "/usr/local/bin/che-ical-mcp"
    }
  }
}

For Claude Code (CLI)

Option A: Install as Plugin (Recommended)

The plugin includes slash commands (/today, /week, /quick-event, /remind), skills, and a PreToolUse hook that automatically verifies day-of-week when creating or updating events — preventing date/weekday mismatch errors.

Two steps — register the marketplace once, then install the plugin:

# 1. Register the marketplace (one-time)
claude plugin marketplace add PsychQuant/psychquant-claude-plugins

# 2. Install the plugin
claude plugin install che-ical-mcp@psychquant-claude-plugins

Inside Claude Code? The slash-command equivalents /plugin marketplace add PsychQuant/psychquant-claude-plugins and /plugin install che-ical-mcp@psychquant-claude-plugins work the same way.

Note: The plugin wraps the MCP binary with auto-download. If the binary is not found at ~/bin/CheICalMCP, it will be downloaded from GitHub Releases on first use.

Option B: Install as standalone MCP

If you only need the MCP server without plugin features:

# Create ~/bin if needed
mkdir -p ~/bin

# Download the latest release
# Note: if upgrading from an older version, `rm -f ~/bin/CheICalMCP` first.
# Without this, on macOS 26 the kernel may kill the new binary

... [View full README on GitHub](https://github.com/PsychQuant/che-ical-mcp#readme)