Skip to content

v1.22.0

Choose a tag to compare

@kiki830621 kiki830621 released this 27 Oct 02:59
· 139 commits to main since this release
f29a468

Changed

  • Under Claude Code, CheICalMCP becomes its own responsible process for Calendar and Reminders (#343, v1.22.0): macOS charges an EventKit request to the responsible process the kernel assigned at spawn time, not to the binary, and Claude Code's background daemon launches sessions two ways: a spare-claimed session inherits the app that launched the daemon (on the reporting machine, VS Code), while a worker the daemon starts through ClaudeCode.app (for example after Claude Code is restarted) is its own responsible process at ~/.local/share/claude/versions/<ver>, which has no Calendar or Reminders purpose string, so macOS never shows a prompt and the session cannot read the calendar. When the responsible process macOS reports is Claude Code (its native executable under ~/.local/share/claude/versions/<ver>, or ClaudeCode.app), the binary now re-execs in place with posix_spawn + POSIX_SPAWN_SETEXEC + responsibility_spawnattrs_setdisclaim (the call Claude Desktop's disclaimer makes; looked up with dlsym), keeping its pid, argv and stdio, so macOS checks the CheICalMCP grant and Claude Code updates no longer invalidate it (#170). This covers the MCP server, --cli, --print-tcc-path and --setup; --setup also re-execs under any host, because it is the foreground action that creates CheICalMCP's own grant. Every other host (Terminal, VS Code, Ghostty, ssh, cron, CI) keeps the behavior before this change: the host's grant is checked and nothing is re-exec'd, because a host's grant can be the only one that works while CheICalMCP's own is still empty. --version, --help and --self-update never re-exec; Claude Desktop's .mcpb server is already its own responsible process and is unchanged. Migration: under Claude Code the CheICalMCP grant may be empty, so after upgrading allow the macOS prompt for CheICalMCP once, or run ~/bin/CheICalMCP --setup in the foreground; a background session without a GUI cannot show the prompt. Trade-off: where the re-exec happens, macOS checks CheICalMCP's grant, so once it is allowed, any process Claude Code launches that execs this binary (including --cli) reads Calendar and Reminders under that grant without a separate consent, the same property Claude Desktop's .mcpb has through disclaimer. Set CHE_ICAL_MCP_NO_DISCLAIM=1 to restore host attribution (the behavior before v1.22.0); set CHE_ICAL_MCP_FORCE_DISCLAIM=1 to re-exec under any host, for someone who wants CheICalMCP's own grant everywhere (NO_DISCLAIM wins over it). A missing private API or a failed re-exec prints one stderr line and continues under the host's attribution; an inherited CHE_ICAL_MCP_DISCLAIMED while Claude Code is still the responsible process also prints one. Not verified: CI does not cover reading the calendar through the new path under Claude Code, and the only path where a prompt has been seen is --setup; server mode and --cli under Claude Code are unconfirmed. On the maintainer's machine the host (Ghostty) held a working fullAccess grant while CheICalMCP's own status was notDetermined, which is why other hosts are left alone.

Fixed

  • TCC diagnostics name the process macOS checks (#343): --print-tcc-path prints a TCC attribution block from the kernel (responsibility_get_pid_responsible_for_pid) before the status; the parent chain is relabeled Process tree (parent chain — not what TCC checks), and its note no longer says the status reflects the chain. The startup banner's #175 check looked for a versions/ path on the parent chain and blamed that host even when another process was responsible; it now reports the responsible process (hostAttributedUngranted) with advice for its kind. The access-denied message no longer tells users to "Enable access for the MCP server or Terminal": it names CheICalMCP, Claude Code (cannot be prompted) or the app whose grant is checked. --setup prints the authorization target before asking.

Plugin shell

The troubleshoot-tcc skill, /check-tcc and the plugin docs describe the new attribution; see plugin/CHANGELOG.md.