New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Apple Tools

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Reach Apple PIM data (Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) from a pi session via iMCP + pi's built-in MCP on macOS.

MITAuto-check passedProductivity & Automation

Install Apple Tools

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard apple-tools --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/apple-tools/.pi/skills/apple-tools .claude/skills/apple-tools && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apple-tools
GitHub stars
315
Token cost
~760 tokens
SKILL.md length
351 words
Files
1
Skills in repo
66
Repo updated
First seen
Licence
MIT

At a glance

Reach Apple PIM data (Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) from a pi session via iMCP + pi's built-in MCP on macOS.

  • The user asks to read/search their Apple Calendar
  • SKILL.md covers Reachable services (seven), Mail is out of scope — redirect, Access pattern — search then… and Provisioning check (run at load), plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Current Location

What it does

Apple Tools is an agent skill from BlackBeltTechnology/pi-agent-dashboard. 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.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Transactional email and Messaging and chat bots. It works with Model Context Protocol and macOS. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

When your agent uses it

  • The user asks to read/search their Apple Calendar
  • Current Location

Example prompts

  • “/apple-tools”

What it can do on your machine

Read from SKILL.md and the folder at commit 86e8e4d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Apple Tools loads about 760 tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 351 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~760

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BlackBeltTechnology/pi-agent-dashboard at commit 86e8e4d, republished under its MIT licence (© BlackBeltTechnology). 351 words, ~760 tokens.

Download SKILL.mdSave it as .claude/skills/apple-tools/SKILL.md (or your agent's skills folder).
name
apple-tools
description
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.

apple-tools (iMCP)

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

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 built-in MCP

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.

Show full SKILL.md (185 more words)Show less

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

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.

© BlackBeltTechnology, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in packages/apple-tools/.pi/skills/apple-tools of BlackBeltTechnology/pi-agent-dashboard.

Open the folder on GitHubat commit 86e8e4d

Compare with similar skills

Apple Tools next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apple Tools compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Tools this skillBlackBeltTechnology/pi-agent-dashboard315—~760Automated safety check: PassMIT
Orchardokooo5km/Skills4U183—~5kAutomated safety check: WarnMIT
Feishu BridgeAlexAnys/feishu-openclaw3171 repos~615Automated safety check: PassNone
Interceptor BrowserHacker-Valley-Media/Interceptor519—~4.8kAutomated safety check: PassCustom licence
E2atokencanopy/e2a193—~4.7kAutomated safety check: PassApache-2.0
SetupRich627/whatsapp-claude-plugin103—~1.4kAutomated safety check: NotesApache-2.0

Similar skills

  • Orchard

    okooo5km/Skills4U

    Use the local Orchard app to interact with macOS Apple apps and services: Calendar, Reminders, Clock, Mail, Contacts, Notes, Music, Weather, Messages, Location/Maps, and Apple Shortcuts.

    183 GitHub stars~5k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check: warnings

  • Feishu Bridge

    AlexAnys/feishu-openclaw

    Connect a Feishu (Lark) bot to Clawdbot via WebSocket long-connection.

    317 GitHub starsUsed in 1 repo~615 tokens
    Productivity & AutomationAuto-check passed

  • Interceptor Browser

    Hacker-Valley-Media/Interceptor

    Drive a signed-in Chrome / Brave / Safari session via the interceptor CLI: open/read pages, click, type, inspect DOM/text/network, automate rich browser editors and scene graphs, capture…

    519 GitHub stars~4.8k tokensUpdated 6 days ago
    Productivity & AutomationAuto-check passed

  • E2a

    tokencanopy/e2a

    A skill your agent uses when operating an already-connected e2a inbox over MCP: reading, composing, sending, replying, forwarding, handling attachments, managing contacts/outreach, scheduling mail…

    193 GitHub stars~4.7k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed

  • Setup

    Rich627/whatsapp-claude-plugin

    Interactive WhatsApp channel onboarding — guides through device linking, phone number config, and access control setup

    103 GitHub stars~1.4k tokensUpdated today
    Productivity & AutomationAuto-check: notes

  • Feishu

    codewhale-hq/Codewhale

    Work with Feishu or Lark bots, docs, sheets, bitables, approval flows, and OpenAPI/MCP setup without hardcoding credentials.

    41k GitHub stars~413 tokensUpdated today
    Productivity & AutomationAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 66 skills in this repo

  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    315 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    315 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    315 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    315 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Apple Tools

What does Apple Tools do?

Reach Apple PIM data (Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) from a pi session via iMCP + pi's built-in MCP on macOS. Apple Tools is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Reach Apple PIM data (Calendar, Contacts, Reminders, Messages, Location, Maps, Weather) from a pi session via iMCP + pi's built-in MCP on macOS.

When should I use Apple Tools?

Apple Tools fits situations like: the user asks to read/search their Apple Calendar; current Location.

How do I install Apple Tools in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a claude-code`. Or copy the skill folder (packages/apple-tools/.pi/skills/apple-tools in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/apple-tools in your project. Claude Code loads it when a task matches its description.

How do I install Apple Tools in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a codex`. Or copy the skill folder (packages/apple-tools/.pi/skills/apple-tools in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/apple-tools in your project. Codex loads it when a task matches its description.

Can I use Apple Tools in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill apple-tools -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apple-tools, .gemini/skills/apple-tools, .github/skills/apple-tools and .opencode/skills/apple-tools in your project.

What does Apple Tools need to run?

SKILL.md names no scripts, command-line tools or credentials: Apple Tools is instructions for the agent only.

Does Apple Tools access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Apple Tools safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Apple Tools use?

Apple Tools is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apple Tools use?

About 760 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Apple Tools?

Skills that share tags, products or a category with Apple Tools: Orchard (okooo5km/Skills4U, 183 stars), Feishu Bridge (AlexAnys/feishu-openclaw, 317 stars), Interceptor Browser (Hacker-Valley-Media/Interceptor, 519 stars) and E2a (tokencanopy/e2a, 193 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Tools?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 8, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.