1. Conduid
  2. Developer Tools
  3. Nucleus Apple MCP
MCP server · Developer Tools

Nucleus Apple MCP

by · github.com/zish-rob-crur/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.

Unclaimed last commit 6 months ago devtools
InstallView source
48Fair

Scored 3 months ago · breakdown

About Nucleus Apple MCP

Nucleus Apple MCP is an MCP server published by zish-rob-crur in the Developer Tools category: 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. It has been installed 0 times through Conduid.

The repository has 8 stars and 2 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx nucleus-apple-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Nucleus Apple MCP

Powered by Claude · Grounded in docs

I know everything about Nucleus Apple MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

中文版

⚛️ 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. Download the iOS app from the App Store: Nucleus Context Hub.

🔌 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/<build_id>/nucleus-apple-sidecar
  • Optional Env Vars: NUCLEUS_APPLE_MCP_CACHE_DIR (overrides cache directory), NUCLEUS_SWIFT (swift path), NUCLEUS_SWIFTC (swiftc path)

🚀 Usage

# 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:

uv tool install nucleus-apple-mcp

Examples:

# 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

# Add the server (writes to ~/.codex/config.toml)
codex mcp add nucleus-apple -- uvx nucleus-apple-mcp

# Verify
codex mcp list

Claude Code

# 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:

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:

install skill https://github.com/zish-rob-crur/nucleus-apple-mcp nucleus-apple-health

README mirrored from the source repository 3 months ago. The original is authoritative.

Questions

About Nucleus Apple MCP

How do I install Nucleus Apple MCP?

Run npx nucleus-apple-mcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Nucleus Apple MCP safe to use with an AI agent?

Its trust score is 48 out of 100 (fair). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Nucleus Apple MCP still maintained?

The last commit was 6 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.