Skip to content

Repository files navigation

MacCoreBridge MCP

CI Website macOS Swift License: MIT

Your personal data, securely within reach of any AI.

MacCoreBridge MCP is a native macOS menu bar application that exposes Apple Calendar and Reminders through the Model Context Protocol (MCP). It acts as a secure, local bridge between AI assistants and your personal data — vendor-neutral by design.

Built by WeSell.Solutions · Product site

Screenshots

Menu bar popover Settings — General
Menu bar popover Settings — General
Server status, integrations, security Launch at login and general preferences
Settings — MCP server Settings — Audit log
Settings — MCP server Settings — Audit log
Endpoint, auth, client config export On-device MCP activity log

Status

Active development. Phases 0–8 complete (menu bar app, Calendar/Reminders MCP tools, security, client interoperability). See roadmap.

Goals

  • Native macOS app (Swift, SwiftUI) — no Electron
  • MCP server on localhost for Claude Desktop, Cursor, VS Code, and other MCP clients
  • Calendar and Reminders via EventKit with proper TCC permissions
  • Strict layer boundaries: MCP → domain services → EventKit adapters
  • Local-first security; remote access is future and opt-in

Requirements

  • macOS 15+ (deployment target may change)
  • Xcode 16+
  • Cursor IDE (recommended for development)

Building

xcodebuild -project MacCoreBridge.xcodeproj \
  -scheme MacCoreBridge \
  -destination 'platform=macOS' \
  build

Run tests:

xcodebuild -project MacCoreBridge.xcodeproj \
  -scheme MacCoreBridge \
  -destination 'platform=macOS' \
  -only-testing:MacCoreBridgeTests \
  test

CI runs unit tests only (MacCoreBridgeTests). UI tests are skipped until real menu-bar UI automation is implemented.

Project structure

MacCoreBridge/          Xcode app target — see MacCoreBridge/README.md
MacCoreBridgeTests/     Unit and integration tests
MacCoreBridgeUITests/   UI tests
docs/                   Architecture, ADRs, contracts, security
.cursor/                Cursor rules, agents, skills, commands

Canonical folder map: docs/architecture/source-layout.md (must match the repository).

See docs/architecture/overview.md and docs/development/roadmap.md.

Documentation

Document Description
maccorebridge.wesell.ro Product presentation site
docs/architecture/overview.md Layer boundaries and dependency rules
docs/architecture/source-layout.md Canonical MacCoreBridge/ folder map
docs/product/identity.md Product name, branding, positioning
docs/product/screenshots/ Product screenshots (README, marketing)
docs/adr/ Architecture Decision Records
docs/contracts/ Interface contracts (MCP, Calendar, Reminders, Security)
docs/security/threat-model.md Threat model
docs/development/mcp-client-compatibility.md MCP client setup and compatibility
CONTRIBUTING.md Git Flow and contribution guidelines
docs/development/quality-gate.md Pre-merge and release checklists

License

MIT — see LICENSE.


WeSell.Solutions — native macOS and product engineering.

About

MCP that allow read todos and calenda to allow organize your dau sing AI

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages