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.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"nucleus-apple-mcp": {
"args": [
"nucleus-apple-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'nucleus-apple-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked nucleus-apple-mcp against OSV.dev.
Click any tool to inspect its schema.
health_dataRead raw Apple Health samples from an S3-compatible object store
health://samples
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in productivity / health
Persistent memory using a knowledge graph
Dynamic problem-solving through sequential thought chains
mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local
Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.
MCP Security Weekly
Get CVE alerts and security updates for Nucleus Apple Mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
Terminal + MCP demo: Nucleus summarizes a 30-day recovery trend from exported Health data.
EventKit.EventKit.swift build) to interface directly with macOS private frameworks, bypassing the limitations of Python-Objective-C bridges.src/nucleus_apple_mcp/sidecar/swift/ (includes Package.swift; CLI uses swift-argument-parser)~/Library/Caches/nucleus-apple-mcp/sidecar/<build_id>/nucleus-apple-sidecarNUCLEUS_APPLE_MCP_CACHE_DIR (overrides cache directory), NUCLEUS_SWIFT (swift path), NUCLEUS_SWIFTC (swiftc path)# Run the CLI directly.
uvx --from nucleus-apple-mcp nucleus-apple health list-sample-catalog
# Or run the MCP server.
uvx nucleus-apple-mcp
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.
This server uses the stdio transport (a local subprocess). The first run will compile the Swift sidecar.
# Add the server (writes to ~/.codex/config.toml)
codex mcp add nucleus-apple -- uvx nucleus-apple-mcp
# Verify
codex mcp list
# 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
This repository includes reusable agent skills under skills/ for:
nucleus-apple-calendarnucleus-apple-remindersnucleus-apple-notesnucleus-apple-healthEach s