---
name: Apple Tools
slug: apple-tools
category: Automation
description: Apple Tools reaches Calendar, Contacts, Reminders, Messages, Location, Maps, and Weather data on macOS through iMCP and pi-mcp-adapter. Use it to read or search Apple personal data; it does not cover Apple Mail.
github: "https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/apple-tools/.pi/skills/apple-tools"
language: TypeScript
stars: 267
forks: 38
install: "npx degit https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/apple-tools/.pi/skills/apple-tools ~/.claude/skills/apple-tools"
installs_to: ~/.claude/skills/apple-tools
source_path: packages/apple-tools/.pi/skills/apple-tools/SKILL.md
collection_size: 5
category_size: 1525
collection_url: "https://dirskills.com/collections/BlackBeltTechnology/pi-agent-dashboard"
added: 2026-09-01T14:36:04.665Z
last_synced: 2026-09-01T14:36:04.665Z
canonical_url: "https://dirskills.com/skills/apple-tools"
---

# Apple Tools

Apple Tools reaches Calendar, Contacts, Reminders, Messages, Location, Maps, and Weather data on macOS through iMCP and pi-mcp-adapter. Use it to read or search Apple personal data; it does not cover Apple Mail.

**Install:**

```bash
npx degit https://github.com/BlackBeltTechnology/pi-agent-dashboard/tree/develop/packages/apple-tools/.pi/skills/apple-tools ~/.claude/skills/apple-tools
```

## README

# apple-tools (iMCP)

Access Apple personal-information-management data on **macOS** through
[iMCP](https://github.com/mattt/iMCP), a menu-bar app that brokers the OS
permission grants, reached over MCP by `pi-mcp-adapter`.

## Reachable services (seven)

Calendar · Contacts · Location · Maps · Messages · Reminders · Weather

- **Messages** here means **iMessage / SMS** — it is NOT email.
- There is **no Mail service**. iMCP exposes no Apple Mail access.

## Mail is out of scope — redirect

If the user asks to read, search, or summarize **Apple Mail / email**:

- iMCP exposes **no Mail service**; do not attempt an iMCP/adapter tool call for Mail.
- Use the **`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.

## Access pattern — search then invoke via the adapter

The agent reaches iMCP tools through **`pi-mcp-adapter`**, not by spawning the
server. Do **not** run `imcp-server` directly. Use the adapter's MCP tool
surface (search the available tools, then invoke).

## Provisioning check (run at load)

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 the adapter, 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.

## Permission grants are manual and out-of-band

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).

- The load-time check **cannot detect a revoked grant** ahead of a call.
- A permission-class failure at call time means the grant was **revoked or never
  given** → the fix is **menu-bar remediation**, NOT re-running the installer.
  Re-running `pi-apple-tools-install` will not restore a TCC grant.