# Nucleus Apple Mcp > A macOS Model Context Protocol (MCP) server that acts as the central nervous system for your AI agent. Bridges Calendar, Reminders, Notes, and Health data using a hybrid Python + Swift architecture. - **Type:** MCP server - **Install:** `agentstack add mcp-zish-rob-crur-nucleus-apple-mcp` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [zish-rob-crur](https://agentstack.voostack.com/s/zish-rob-crur) - **Installs:** 0 - **Category:** [Productivity](https://agentstack.voostack.com/c/productivity) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [zish-rob-crur](https://github.com/zish-rob-crur) - **Source:** https://github.com/zish-rob-crur/nucleus-apple-mcp ## Install ```sh agentstack add mcp-zish-rob-crur-nucleus-apple-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About [中文版](README.zh-CN.md) # ⚛️ Nucleus: macOS Life Context Server **Give your AI Agent a Hippocampus.** `nucleus-apple-mcp` is a Model Context Protocol (MCP) server designed to unify your digital life on macOS. It allows AI agents (like Claude Desktop, Cursor, or custom agents) to securely read and interact with your personal data ecosystem. Unlike fragile PyObjC bridges, **Nucleus** uses a hybrid architecture: a Python MCP server that orchestrates lightweight, JIT-compiled native Swift workers. This ensures type-safe, performant, and reliable access to Apple's native APIs while remaining easily distributable via `uvx`. For a product overview and setup path, see [docs/introducing-nucleus.md](docs/introducing-nucleus.md). Download the iOS app from the App Store: [Nucleus Context Hub](https://apps.apple.com/us/app/nucleus-context-hub/id6760659033). Terminal + MCP demo: Nucleus summarizes a 30-day recovery trend from exported Health data. ## 🔌 Integrations ### ✅ Available (current release) * **📅 Calendar:** Fetch upcoming schedules, check availability, and create events via `EventKit`. * **✅ Reminders:** Read pending tasks and manage your to-do lists via `EventKit`. * **📝 Notes:** List/search notes, read content, and add/export attachments via Notes.app (Apple Events). * **❤️ Health:** Read exported Apple Health metrics and raw samples from an S3-compatible object store. ### 🏗 Architecture * **Python:** Handles the MCP protocol, request routing, and distribution (pip/uv). * **Swift:** Embedded source code acts as a "Sidecar." It is compiled locally on the first run (using SwiftPM `swift build`) to interface directly with macOS private frameworks, bypassing the limitations of Python-Objective-C bridges. ### 📦 Swift Sidecar Layout * **Swift Package Root:** `src/nucleus_apple_mcp/sidecar/swift/` (includes `Package.swift`; CLI uses `swift-argument-parser`) * **Build Cache (macOS):** `~/Library/Caches/nucleus-apple-mcp/sidecar//nucleus-apple-sidecar` * **Optional Env Vars:** `NUCLEUS_APPLE_MCP_CACHE_DIR` (overrides cache directory), `NUCLEUS_SWIFT` (swift path), `NUCLEUS_SWIFTC` (swiftc path) ### 🚀 Usage ```bash # Run the CLI directly. uvx --from nucleus-apple-mcp nucleus-apple health list-sample-catalog # Or run the MCP server. uvx nucleus-apple-mcp ``` ## 🧰 CLI Install the package once and use the unified `nucleus-apple` command: ```bash uv tool install nucleus-apple-mcp ``` Examples: ```bash # Calendar nucleus-apple calendar list-events --start 2026-03-15T09:00:00+08:00 --end 2026-03-15T18:00:00+08:00 --pretty # Reminders nucleus-apple reminders list-reminders --due-end 2026-03-20 --pretty # Notes nucleus-apple notes list-notes --query project --include-plaintext-excerpt --pretty # Health nucleus-apple health read-daily-metrics --date 2026-03-14 --pretty ``` The CLI mirrors the MCP tool surface and emits JSON, which makes it suitable for shell automation and agent skill workflows. ## 🔧 Add as an MCP server This server uses the **stdio** transport (a local subprocess). The first run will compile the Swift sidecar. ### Codex CLI ```bash # Add the server (writes to ~/.codex/config.toml) codex mcp add nucleus-apple -- uvx nucleus-apple-mcp # Verify codex mcp list ``` ### Claude Code ```bash # Add the server (use --scope user to make it available globally) claude mcp add --scope user nucleus-apple -- uvx nucleus-apple-mcp # Verify claude mcp list ``` You can also launch the server through the CLI: ```bash nucleus-apple mcp serve ``` ## 🪝 OpenClaw + Hermes Agent Skills This repository includes reusable agent skills under `skills/` for: * `nucleus-apple-calendar` * `nucleus-apple-reminders` * `nucleus-apple-notes` * `nucleus-apple-health` Each skill depends on the `nucleus-apple` binary and is designed to be reused without changing the command surface. If your agent supports repo-based skill install via chat, you can say: ```text install skill https://github.com/zish-rob-crur/nucleus-apple-mcp nucleus-apple-health ``` ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [zish-rob-crur](https://github.com/zish-rob-crur) - **Source:** [zish-rob-crur/nucleus-apple-mcp](https://github.com/zish-rob-crur/nucleus-apple-mcp) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** yes - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-zish-rob-crur-nucleus-apple-mcp - Seller: https://agentstack.voostack.com/s/zish-rob-crur - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.