che-ical-mcp

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. This repo is its own self-hosted marketplace (the plugin definition lives in plugin/):

# 1. Register the marketplace (one-time)
claude plugin marketplace add PsychQuant/che-ical-mcp

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

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

Add via git, not a raw URL. The marketplace's plugin source is a same-repo relative path (./plugin), which only resolves when the marketplace is added through its Git repo (GitHub owner/repo, as above) — not via a direct URL to marketplace.json.

The plugin is also still bundled in the psychquant-claude-plugins aggregator (claude plugin install che-ical-mcp@psychquant-claude-plugins); both serve the same versioned binary.

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 with a stale
# code-signature cache from the old inode (which running MCP processes might
# still be holding open).
rm -f ~/bin/CheICalMCP
curl -L https://github.com/PsychQuant/che-ical-mcp/releases/latest/download/CheICalMCP -o ~/bin/CheICalMCP
chmod +x ~/bin/CheICalMCP