@blackbelt-technology/pi-dashboard-apple-tools
v0.7.0
Published
Provision and surface iMCP (Apple PIM: Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) for pi. One-command installer, a dashboard provisioning panel, and an agent skill. macOS-only; no Apple Mail.
Readme
@blackbelt-technology/pi-dashboard-apple-tools
Provision and surface iMCP — Apple PIM (Calendar, Contacts, Reminders,
Messages, Location, Maps, Weather) — for a pi session on macOS, reached
through pi-mcp-adapter.
macOS only. No Apple Mail. iMCP exposes no Mail service; "Messages" is iMessage/SMS, not email. For email use the
apple-mail-fast-exportskill.
What it does
Three moving parts must line up before a single Apple tool call works:
- iMCP.app installed —
brew install --cask mattt/tap/iMCP pi-mcp-adapterloaded — an entry in~/.pi/agent/settings.jsonpackages[]mcp.jsonentry present —mcpServers.iMCP.commandin~/.pi/agent/mcp.json- TCC grants — manual, in the iMCP menu-bar app (Apple's security model has no API; this step cannot be automated)
Steps 1–3 are automated by this package. Step 4 is a documented manual click.
Install
pi install npm:@blackbelt-technology/pi-dashboard-apple-toolsInstalling the package does nothing on its own (no postinstall). Provisioning
is opt-in:
pi-apple-tools-install # provision (writes mcp.json + settings.json)
pi-apple-tools-install --check # report the state without changing anythingProvisioning states
A closed nine-member enum, identical across the CLI, the dashboard panel, and
the doctor probe:
UNSUPPORTED_PLATFORM · OS_VERSION_UNKNOWN · OS_TOO_OLD ·
NO_INSTALL_METHOD · INSTALL_FAILED · CONFIG_UNPARSEABLE ·
CONFIG_WRITE_FAILED · READY_PENDING_GRANTS · READY
READY_PENDING_GRANTS means everything is wired but you still need to grant
permissions in the iMCP menu-bar app. Minimum macOS: 15.3.
Manual grant step
After READY_PENDING_GRANTS, open the iMCP menu-bar app and grant each Apple
service you need. Grants can be revoked out of band at any time and cannot be
detected ahead of a call — a permission-class failure means menu-bar
remediation, not re-running the installer.
Dashboard panel
The plugin contributes a settings section under its own row in the Plugins tab:
status readout, Run installer, imcp-server path override, directTools
selection, and a server enable/disable toggle (writes a disabled override to
the project-local .pi/mcp.json). It has no per-service toggles — those are
menu-bar only.
