开源MCP工具

Requirements

• macOS 14.0+ (Sonoma or later — required since cluster v1.11.0+ for full TCC permission API support)
• Xcode Command Line Tools (only if building from source)

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:

Build from Source (Optional)

git clone https://github.com/PsychQuant/che-ical-mcp.git
cd che-ical-mcp
make release && make install

⚠️ Swift 6 / Xcode 18 users: Do not use swift build directly — upstream MCP SDK has a concurrency error (swift-sdk#214). The Makefile auto-detects this and falls back to Swift 5 language mode.

On first use, macOS will prompt for Calendar and Reminders access - click "Allow".

Upgrading an existing install

The plugin wrapper auto-downloads on fresh installs, but does NOT replace an existing binary. To upgrade in place:

~/bin/CheICalMCP --self-update

This queries GitHub Releases for the latest tag, downloads the new binary, and atomically replaces the current one. If the binary is currently running as an MCP server, restart your MCP host (Claude Desktop / Claude Code) afterward to pick up the new version. Manual alternative if --self-update is unavailable: rm -f ~/bin/CheICalMCP && curl -L https://github.com/PsychQuant/che-ical-mcp/releases/latest/download/CheICalMCP -o ~/bin/CheICalMCP && chmod +x ~/bin/CheICalMCP.

---

Installation

Build from Source (Optional)

```bash git clone https://github.com/PsychQuant/che-ical-mcp.git cd che-ical-mcp make release && make install

-t install → accepted; source=Notarized Developer ID ← use this

the .app bundle check. -t install is the documented assessment type for

software being installed (which describes how a CLI binary lands in ~/bin),

Quick Start

Usage Examples

Apple's Code Signing Guide describes -t execute as the assessment type for

-- : separator between claude options and the command

claude mcp add --scope user --transport stdio che-ical-mcp -- ~/bin/CheICalMCP ```

💡 Tip: Always install the binary to a local directory like ~/bin/. Avoid placing it in cloud-synced folders (Dropbox, iCloud, OneDrive) as file sync operations can cause MCP connection timeouts.

CLI Mode (No MCP Server)

All 29 tools can be invoked directly from the command line without running the MCP server:

```bash

not raw Mach-O CLI binaries)

Troubleshooting