Skip to content
CAI
Software that uses CAICheck a score

mattt/iMCP

57.1

Adequate · 15 November 2026

21k

lines of production code

Swift

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add HomeKit support via a Mac Catalyst helper with developer build and release automation scripts

Users can now control HomeKit accessories through iMCP by using a nested 'iMCP Helper' app built with Mac Catalyst. Because Apple restricts the HomeKit entitlement in Developer ID-signed releases, the main app's release build excludes the helper; instead, developers must use the new \Scripts/install-helper.sh\ to build, sign, and install the helper locally. The \Scripts/build-helper.sh\ script integrates this build step into the Xcode build phase, while \Scripts/check-home.py\ provides automated validation of the Home tools. Additionally, \Scripts/release.sh\ automates the full release workflow, including version bumping, notarization, Sparkle appcast generation, and GitHub release publishing.

Scripts · high confidence

Centralized service management and connection approval in ServerController

The new ServerController centralizes the application's service registry and connection handling logic. It introduces a ServiceRegistry that aggregates available services (such as Calendar, Capture, Contacts, Location, Maps, Messages, Phone, Reminders, Shortcuts, and Utilities) and manages their individual enablement states via AppStorage bindings. Additionally, it implements a connection approval workflow using a dedicated window controller, tracking active approval dialogs and pending approvals to manage client access securely. Also in this area: 1 commit (0 fixes) modifying (repo-wide); Bonjour service discovery no longer advertises or uses the port in TXT records; Shortened JSON-LD tool results via Ontology upgrade; HomeKit support via embedded Mac Catalyst helper; Voicemail service integration and configuration; and 1 more.

App/Controllers · low confidence · unverified

Initial release of iMCP with expanded service support and new documentation

This entry marks the initial public release of iMCP, a macOS app that connects AI clients to local data via the Model Context Protocol. The release introduces a comprehensive suite of services including Calendar, Contacts, Home, Mail, Maps, Messages, Music, Notes, Phone, Reminders, Shortcuts, Voice Memos, Voicemail, and Weather, with specific enhancements such as recurrence support in Reminders and folder-grant access for Mail and Voice Memos. The project has been transferred from Loopwork, switching its license from Apache 2.0 to MIT, and now includes a formal security policy, Swift formatting rules, and updated installation instructions supporting Homebrew and various AI clients like Claude Desktop and the ChatGPT desktop app.

(repo-wide) · high confidence

Introduce embedded Mac Catalyst helper for HomeKit access

A new standalone iMCP Helper app has been added to provide HomeKit capabilities via an embedded Mac Catalyst interface. This helper manages its own local network service (Bonjour) and runs a secure MCP server over TLS, requiring a one-time pairing code to connect to the main iMCP application. It exposes a comprehensive set of HomeKit tools, allowing users to list and manage homes, rooms, zones, accessories, scenes, and automations, as well as read and write accessory characteristics.

Helper · high confidence

Introduce new system services and capture extensions

This change adds several new service modules—Capture, Maps, Phone, and Shortcuts—along with a suite of AVFoundation, AppKit, Contacts, CoreGraphics, EventKit, Foundation, MapKit, and ScreenCaptureKit extensions. The new services expose tools for taking photos, searching places, fetching call history, and running macOS shortcuts, while the extensions provide helper enums and parsing logic (such as lenient ISO 8601 date handling and contact label mapping) that support these capabilities and existing calendar functionality.

App/Services · high confidence

Behavioural changes

8 commits (0 fixes) modifying iMCP.xcodeproj/project.xcworkspace/xcuserdata

A change to existing behaviour in iMCP.xcodeproj/project.xcworkspace/xcuserdata — 8 commits, 2 files: “Configure JSON encoding format options (\#32)”; “Initial commit”; “Update WeatherService to encode conditions with Ontology package (\#31)”; and 5 more (refs \#32, \#31, \#29, \#35, \#30, …).

iMCP.xcodeproj/project.xcworkspace/xcuserdata · medium confidence · unverified

App relaunches as a menu-bar-only app with automatic updates and stricter security

The app now runs exclusively as a menu-bar item (removing the standalone window) and persists the user's preference for showing or hiding the icon even if macOS removes it. It integrates the Sparkle framework for automatic update checking, using a new public key, and enforces a single-instance policy. To support these changes, the app's entitlements have been tightened: network and personal data access (contacts, calendars, location) are removed, and a new debug entitlements file is added for development.

App · high confidence

Disable automatic scheme creation in Xcode workspace

The workspace settings now explicitly disable the automatic creation of Xcode schemes (contexts) when needed. This ensures that schemes are not generated implicitly during development, giving developers more control over their build configurations and preventing unexpected scheme proliferation.

iMCP.xcodeproj/project.xcworkspace/xcshareddata · high confidence

Improved Claude Desktop configuration handling and UI updates

The iMCP integration now provides a more robust setup experience for Claude Desktop. The configuration panel has been renamed to "Set Up iMCP Server" and its messaging clarifies whether it will create or update the config file. Under the hood, the code now preserves existing MCP server configurations when adding iMCP, rather than overwriting them. It also supports the \env\ field for MCP server entries in the config. Additionally, the JSON encoder now sorts keys for consistent output, and the app uses a new bundle identifier key (\me.mattt.iMCP\) for storing the config file bookmark.

App/Integrations · high confidence

Redesigned menu panel and settings with per-tool toggles and connection approval

The app's main interface has been rebuilt from a MacControlCenter-style menu to a custom SwiftUI panel, introducing granular control over individual tools within each service. Users can now manage service and tool availability directly in the Settings \> Services view, where each tool is listed with its own toggle and a read-only indicator. The connection approval workflow has been enhanced to display the specific services a client will access and includes an "Always trust" option to bypass future prompts for known clients. Additionally, the General settings now support Launch at Login and a trusted client list with per-item removal, while the menu bar copy command plays a confirmation sound.

App/Views · high confidence

Removal of SourceKit warning suppression rule

The custom rule that previously instructed the AI to ignore spurious SourceKit warnings (such as 'Cannot find type' or 'No such module') in Swift files has been removed. Users will no longer have this specific behavior applied to their Swift code, meaning the AI may now report or attempt to resolve these warnings instead of assuming types and modules are correctly installed.

.cursor · high confidence

Stabilizes CLI connection handling and Bonjour discovery

The CLI now uses a dedicated \MCPService\ backed by Swift's \ServiceLifecycle\ to manage the connection loop, preventing fatal crashes when the Bonjour connection drops mid-session. Discovery logic has been refactored into \BonjourDiscovery\ to ensure the browser is always cancelled on exit paths, fixing resource leaks. Additionally, connections are now established over loopback after discovery to avoid selecting Docker bridge addresses, and the service group configuration uses graceful shutdown behavior to handle connection drops without crashing.

CLI · high confidence

Tool results now use JSON-LD graphs to reduce repetition and improve schema compliance

Service tool outputs (Calendar, Contacts, Location, Mail, Messages, Notes, Reminders, Weather) now return data wrapped in a JSON-LD graph structure. This change moves the \@context\ declaration to the document level, preventing redundant context definitions in every item of a list and ensuring consistent Schema.org typing. Additionally, the Messages service has been updated to deduplicate conversation details, including full participant information only for the first message in a chat while subsequent messages reference the conversation by ID. Location and Mail services also now omit redundant \@type\ fields (such as GeoCoordinates, PostalAddress, Collection, EmailMessage, Person, MediaObject) to produce cleaner, more concise JSON results. Also in this area: Introduce HomeKit tool definitions and input validation in the shared layer. Also in this area: 2 commits (0 fixes) modifying Shared.

Shared · medium confidence · unverified

Updated Xcode project settings and test scheme configuration

The iMCP project scheme has been upgraded to Xcode version 2620, and the build configuration for the imcp-server target has been changed to allow running (buildForRunning set to YES). Additionally, a new test scheme (imcp-serverTests) has been added to support running unit tests with the LLDB debugger.

iMCP.xcodeproj/xcshareddata · high confidence

Fixes

Fix crash from multiple resume calls in App/Shared

A new ResumeGate actor has been added to the App/Shared module to prevent crashes caused by calling a checked continuation multiple times. This component ensures that resume logic is executed only once, protecting the application from runtime errors associated with repeated continuation invocations.

App/Shared · high confidence

Test coverage

1 commit adding/updating tests in Tests

Test coverage in Tests — 1 commit, 9 files: “Connect imcp-server over a verified socket and trust clients by credential (\#328)” (refs \#328). Also in this area: 2 commits adding/updating tests in Tests; Updated imcp-server test suite and added search result coverage.

Tests · high confidence · unverified

Dependencies

Introduces imcp-serverTests target and updates framework dependencies

The project now includes a new unit-test target (imcp-serverTests) that bundles BonjourDiscovery and MCPServiceLoop tests, linking against ServiceLifecycle and ServiceLifecycleTestKit. The main app and server targets have been updated to include Sparkle, JSONSchema, and Cocoa frameworks, while removing the deprecated MacControlCenterUI dependency. Also in this area: 1 commit (0 fixes) modifying iMCP.xcodeproj; 2 commits (0 fixes) modifying iMCP.xcodeproj; Renames test group to imcp-serverTests and updates source paths; Shortened JSON-LD tool results via Ontology upgrade; App version updated to 1.7.0; and 3 more.

iMCP.xcodeproj · medium confidence · unverified

Update Swift package dependencies and resolve file

The resolved dependencies file has been updated to reflect several version bumps and package changes. Key updates include Madrid to 0.5.0, JSONSchema to 1.3.1, Ontology to 0.10.0, and the MCP Swift SDK (swift-sdk) to 0.12.0. Additionally, Sparkle was updated to 2.9.6, and new dependencies such as eventsource (1.1.1), swift-async-algorithms (1.0.3), swift-atomics (1.3.0), swift-collections (1.1.4), and swift-nio (2.99.0) were added. Some older dependencies like maccontrolcenterui, menubarextraaccess, and the previous mcp-swift-sdk location were removed or replaced.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 56 → 57 (+0.9)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 71 → 64 (-7.0)
  • Architecture 89 → 96 (+6.5)
  • Maturity 49 → 53 (+3.9)
  • Readiness 50 → 50 (-0.2)
  • Security 86 → 81 (-5.2)
  • Event-Driven 68 → 71 (+3.0)
  • Performance 78 → 100 (+21.7)

Resolved (44)

  • Duplicated block (10 lines × 2) (Shared/Home/HomeTools.swift)
  • Duplicated block (10 lines × 2) (Shared/Home/HomeTools.swift)
  • Duplicated block (12 lines × 2) (App/Services/Calendar.swift)
  • Duplicated block (12 lines × 2) (Shared/Home/HomeTools.swift)
  • Duplicated block (12 lines × 4) (App/Services/Contacts.swift)
  • Duplicated block (12 lines × 4) (App/Services/Notes.swift)
  • Duplicated block (12–15 lines × 2) (App/Services/Maps.swift)
  • Duplicated block (13 lines × 2) (App/Services/Contacts.swift)
  • Duplicated block (13 lines × 2) (App/Services/Mail.swift)
  • Duplicated block (13–15 lines × 2) (App/Services/Calendar.swift)
  • Duplicated block (13–15 lines × 2) (App/Services/Reminders.swift)
  • Duplicated block (13–18 lines × 4) (App/Services/Calendar.swift)
  • Duplicated block (14 lines × 2) (App/Services/Calendar.swift)
  • Duplicated block (14 lines × 2) (App/Services/Location.swift)
  • Duplicated block (14 lines × 2) (App/Services/Phone.swift)
  • Duplicated block (14 lines × 2) (CLI/StdioProxy.swift)
  • Duplicated block (15–16 lines × 2) (App/Services/Mail.swift)
  • Duplicated block (16–18 lines × 3) (App/Services/Mail.swift)
  • Duplicated block (16–19 lines × 3) (App/Services/Calendar.swift)
  • Duplicated block (17 lines × 2) (App/Services/Location.swift)
  • …and 24 more

New (42)

  • Duplicated block (11–12 lines × 2) (App/Services/Mail.swift)
  • Duplicated block (12 lines × 4) (App/Services/Mail.swift)
  • Duplicated block (15–16 lines × 3) (App/Services/Messages.swift)
  • Duplicated block (16–17 lines × 3) (App/Services/Mail.swift)
  • Duplicated block (16–19 lines × 3) (App/Services/Calendar.swift)
  • Duplicated block (17–19 lines × 2) (App/Services/Notes.swift)
  • Duplicated block (20–21 lines × 2) (App/Services/Voicemail.swift)
  • Duplicated block (38 lines × 2) (App/Services/Location.swift)
  • Duplicated block (7–10 lines × 4) (App/Services/Music.swift)
  • Duplicated block (7–8 lines × 2) (App/Controllers/SocketTransport.swift)
  • Duplicated block (8 lines × 2) (App/Services/Calendar.swift)
  • Duplicated block (9 lines × 5) (App/Services/Mail.swift)
  • Edited copies of one member (3 members, 11+ corresponding lines) (App/Services/Notes.swift)
  • Edited copies of one member (3 members, 18+ corresponding lines) (App/Services/Reminders.swift)
  • Edited copies of one member (3 members, 28+ corresponding lines) (App/Services/Phone.swift)
  • Edited copies of one member (4 members, 23+ corresponding lines) (App/Services/Mail.swift)
  • Edited copies of one member (4 members, 8+ corresponding lines) (Helper/Services/HomeKitStore.swift)
  • Edited copies of one member (5 members, 7+ corresponding lines) (App/Services/Messages.swift)
  • Edited copies of one member (7 members, 22+ corresponding lines) (App/Services/Mail.swift)
  • Edited copy of a member (10 corresponding lines) (App/Services/Phone.swift)
  • …and 22 more

Changes since last survey

  • 12 commits — 12 feature/other, 0 fixes

By area

  • iMCP.xcodeproj/project.pbxproj — 4 commits
  • (root) — 2 commits
  • Tests/imcp-serverTests — 2 commits
  • App/Controllers — 1 commit
  • App/Services — 1 commit
  • CLI/MCPInitializeCompatibility.swift — 1 commit
  • Shared/Home — 1 commit

Notable commits

  • change: Add read-only Music playlist tools (#332)
  • change: Bump version to 1.8.1 (#326)
  • change: Bump version to 1.8.2 (#329)
  • change: Bump version to 1.8.3 (#331)
  • change: Bump version to 1.8.4 (#334)
  • change: Connect imcp-server over a verified socket and trust clients by credential (#328)
  • change: Delete reminders through a fresh event store (#322)
  • change: Keep HomeKit's error in refusals and suggest the helper's window (#323)
  • change: Read the pairing key from either keychain (#319)
  • change: Register tool handlers only after a connection is approved (#325)
  • change: Remove every non-string experimental capability from initialize (#333)
  • change: Run Music's AppleScript off the main thread (#307)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

mattt/iMCP was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 22d06c90c8b7115daf07870fa06db076faf40bca — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.