- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/HEAD/packages/apple-tools/.pi/skills/apple-toolsFrom the publisher
Access Apple personal-information-management data on macOS through iMCP, a menu-bar app that brokers the OS permission grants, reached over MCP by pi's built-in MCP (pi ≥ 1.0.0).
Calendar · Contacts · Location · Maps · Messages · Reminders · Weather
If the user asks to read, search, or summarize Apple Mail / email:
apple-mail-fast-export skill instead — it exports .eml files
directly from the on-disk Apple Mail store."Messages" satisfying an email request is a category error: Messages is iMessage/SMS only.
The agent reaches iMCP tools through pi's built-in MCP, not by spawning the
server. Do not run imcp-server directly. Tools appear as mcp__iMCP__*
(through codemode, or tool_search when the entry's exposure is
deferred). Search the available tools, then invoke.
This skill runs the installer's --check traversal on load (one sw_vers plus
a few stat calls; short-circuits instantly on non-macOS). If iMCP is not
provisioned it reports the gap and names the fix:
pi-apple-tools-install
Terminal states mirror the CLI and the dashboard panel:
UNSUPPORTED_PLATFORM, OS_VERSION_UNKNOWN, OS_TOO_OLD, NO_INSTALL_METHOD,
INSTALL_FAILED, CONFIG_UNPARSEABLE, CONFIG_WRITE_FAILED,
READY_PENDING_GRANTS.
READY is NOT one of them. It is a live-access result — reachable only by a
successful tool round-trip through pi's built-in MCP, never by the provisioning
traversal, which cannot know whether the TCC grants were given.
If the state is anything other than READY_PENDING_GRANTS, do NOT attempt
Apple-data tool calls — report the gap and the pi-apple-tools-install
command first.
The final step — granting Calendar/Contacts/… permissions — happens in the iMCP menu-bar app and cannot be automated (Apple's TCC security model has no API).
pi-apple-tools-install will not restore a TCC grant.Reach Apple PIM data (Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) from a pi session via iMCP + pi's built-in MCP on macOS. Use when the user asks to read/search their Apple Calen
---name: apple-toolsdescription: Reach Apple PIM data (Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) from a pi session via…---# packages/apple-tools/.pi/skills/apple-tools/SKILL.mdOverview
Reach Apple PIM data (Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) from a pi session via iMCP + pi's built-in MCP on macOS. Use when the user asks to read/search their Apple Calendar, Contacts, Reminders, iMessages, current Location, Maps, or Weather. Does NOT cover Apple Mail — iMCP exposes no Mail service; use apple-mail-fast-export for email.
FAQ
Download packages/apple-tools/.pi/skills/apple-tools/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/BlackBeltTechnology/pi-agent-dashboard.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.