Nucleus Apple MCP server (macOS EventKit via Swift sidecar).
Project description
⚛️ 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.
🔌 Integrations
- 📅 Calendar: Fetch upcoming schedules, check availability, and create events via
EventKit. - ✅ Reminders: Read pending tasks and manage your to-do lists via
EventKit. - 📝 Notes: Access your Apple Notes database (The "Second Brain" memory layer).
- ❤️ Health: Ingest health metrics (Sleep, HR, Activity) via iOS-to-Mac iCloud exports.
🏗 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/(includesPackage.swift; CLI usesswift-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
# No manual compilation required.
# The Python wrapper handles the local Swift build automatically.
uvx nucleus-apple-mcp
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nucleus_apple_mcp-0.2.0.tar.gz.
File metadata
- Download URL: nucleus_apple_mcp-0.2.0.tar.gz
- Upload date:
- Size: 23.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7aed0fc71b64490225e6b690602e1dbc0743bb24805ca53e7d622d522a8a71b4
|
|
| MD5 |
2ae9e34af9f27f06bf764a3d61851bfb
|
|
| BLAKE2b-256 |
0f8a31c5b83ec92c5baa5218ebe71373a1b950d6d741990bc70c228dba90cd12
|
File details
Details for the file nucleus_apple_mcp-0.2.0-py3-none-any.whl.
File metadata
- Download URL: nucleus_apple_mcp-0.2.0-py3-none-any.whl
- Upload date:
- Size: 37.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
32347edfdd0a42af149741ebce8c6717776fa455301d4d7f432b11526a9cc2f1
|
|
| MD5 |
ba17ba0db5285823ba8b139d48ca13e7
|
|
| BLAKE2b-256 |
a90141a8d5783b7ccd2eca1d8c20119b285ee3eff136119d2733bf4b924af4c6
|
