{"_id":"@blackbelt-technology/pi-dashboard-apple-tools","_rev":"3-769ecf8ce98100ee22f216df6b6eef52","name":"@blackbelt-technology/pi-dashboard-apple-tools","dist-tags":{"latest":"0.9.0"},"versions":{"0.7.0":{"name":"@blackbelt-technology/pi-dashboard-apple-tools","version":"0.7.0","keywords":["pi","pi-dashboard-plugin","imcp","mcp","apple","calendar","contacts","reminders","macos"],"license":"MIT","_id":"@blackbelt-technology/pi-dashboard-apple-tools@0.7.0","maintainers":[{"name":"mbotond","email":"botond.molnar@blackbelt.hu"},{"name":"mrbence","email":"dbence10@gmail.com"},{"name":"robertcsakany","email":"robert.csakany@blackbelt.hu"},{"name":"norbert.herczeg","email":"norbert.herczeg@blackbelt.hu"}],"homepage":"https://github.com/BlackBeltTechnology/pi-agent-dashboard#readme","bugs":{"url":"https://github.com/BlackBeltTechnology/pi-agent-dashboard/issues"},"pi":{"skills":[".pi/skills/apple-tools"]},"bin":{"pi-apple-tools-install":"src/bin/install.ts"},"dist":{"shasum":"893e47c7b5290494e42eee3f436962dd10106b60","tarball":"https://registry.npmjs.org/@blackbelt-technology/pi-dashboard-apple-tools/-/pi-dashboard-apple-tools-0.7.0.tgz","fileCount":13,"integrity":"sha512-+1mSphDj2cfN3pafp1SQZbsZay6goE3DUvkssgdnWoEnfXFkFQXiGImdoHh5//BywDpFbCTyaGsJSYROunK4Rw==","signatures":[{"sig":"MEYCIQC4oqEONq/g4PiilOV8sLhM0pxEZL4R87cd10wPK9+S9QIhAIEp4w3UACvHhRLfZxsKOQBvWCm8+vBGF56qKQBAwgdw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56585},"type":"module","exports":{".":{"types":"./src/client/index.tsx","default":"./src/client/index.tsx"},"./client":{"types":"./src/client/index.tsx","default":"./src/client/index.tsx"},"./server":{"types":"./src/server/index.ts","default":"./src/server/index.ts"}},"gitHead":"fa69fa268e165e428fcb53d51f7d8ebff6b1da61","_npmUser":{"name":"robertcsakany","email":"robert.csakany@blackbelt.hu"},"repository":{"url":"git+https://github.com/BlackBeltTechnology/pi-agent-dashboard.git","type":"git","directory":"packages/apple-tools"},"_npmVersion":"10.9.3","description":"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.","directories":{},"_nodeVersion":"24.15.0","dependencies":{"pi-mcp-adapter":"^2.19.0","@blackbelt-technology/pi-dashboard-shared":"^0.7.0","@blackbelt-technology/dashboard-plugin-runtime":"^0.7.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.0.0","react-dom":"^19.0.0","@types/react":"^19.0.0","@types/react-dom":"^19.0.0"},"peerDependencies":{"react":">=18.0.0","react-dom":">=18.0.0"},"pi-dashboard-plugin":{"id":"apple-tools","claims":[{"slot":"settings-section","component":"AppleToolsSettings"}],"client":"./src/client/index.tsx","server":"./src/server/index.ts","priority":100,"requires":{"paths":["${imcpServerPath}"],"piExtensions":["pi-mcp-adapter"]},"displayName":"Apple Tools","configSchema":"./config.schema.json"},"_npmOperationalInternal":{"tmp":"tmp/pi-dashboard-apple-tools_0.7.0_1786997747418_0.5052329299910485","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@blackbelt-technology/pi-dashboard-apple-tools","version":"0.8.0","keywords":["pi","pi-dashboard-plugin","imcp","mcp","apple","calendar","contacts","reminders","macos"],"license":"MIT","_id":"@blackbelt-technology/pi-dashboard-apple-tools@0.8.0","maintainers":[{"name":"mbotond","email":"botond.molnar@blackbelt.hu"},{"name":"mrbence","email":"dbence10@gmail.com"},{"name":"robertcsakany","email":"robert.csakany@blackbelt.hu"},{"name":"norbert.herczeg","email":"norbert.herczeg@blackbelt.hu"}],"homepage":"https://github.com/BlackBeltTechnology/pi-agent-dashboard#readme","bugs":{"url":"https://github.com/BlackBeltTechnology/pi-agent-dashboard/issues"},"pi":{"skills":[".pi/skills/apple-tools"]},"bin":{"pi-apple-tools-install":"src/bin/install.ts"},"dist":{"shasum":"c78d2ad03722e2e2d1c011e41753d16296c5068c","tarball":"https://registry.npmjs.org/@blackbelt-technology/pi-dashboard-apple-tools/-/pi-dashboard-apple-tools-0.8.0.tgz","fileCount":13,"integrity":"sha512-+LKmmgZSavUOywDW68y1CYaxjZIf7A6Q5YJKQTFZtbfHL8qLzp8mEE50pAWIWCigIfgq742rrnpdKVSi7Lk1ow==","signatures":[{"sig":"MEQCIFPYBL/HDfDrc6wMs0wQJHUy8XKl3z5h1oJpFa4yQvBBAiAoUIEkpgMOIvYsfY4zU0laxgd9cV7CXgJYocj6Qwymag==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blackbelt-technology%2fpi-dashboard-apple-tools@0.8.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":56629},"type":"module","exports":{".":{"types":"./src/client/index.tsx","default":"./src/client/index.tsx"},"./client":{"types":"./src/client/index.tsx","default":"./src/client/index.tsx"},"./server":{"types":"./src/server/index.ts","default":"./src/server/index.ts"}},"gitHead":"9373dfa416660a285475febc0383608fe14270b1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:a18c8013-6354-4093-b403-35e8e3e85a98"}},"repository":{"url":"git+https://github.com/BlackBeltTechnology/pi-agent-dashboard.git","type":"git","directory":"packages/apple-tools"},"_npmVersion":"12.0.2","description":"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.","directories":{},"_nodeVersion":"24.19.0","dependencies":{"pi-mcp-adapter":"^2.19.0","@blackbelt-technology/pi-dashboard-shared":"^0.8.0","@blackbelt-technology/dashboard-plugin-runtime":"^0.8.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.0.0","react-dom":"^19.0.0","@types/react":"^19.0.0","@types/react-dom":"^19.0.0"},"peerDependencies":{"react":">=18.0.0","react-dom":">=18.0.0"},"pi-dashboard-plugin":{"id":"apple-tools","claims":[{"slot":"settings-section","component":"AppleToolsSettings"}],"client":"./src/client/index.tsx","server":"./src/server/index.ts","priority":100,"requires":{"paths":["${imcpServerPath}"],"piExtensions":["pi-mcp-adapter"]},"displayName":"Apple Tools","configSchema":"./config.schema.json"},"_npmOperationalInternal":{"tmp":"tmp/pi-dashboard-apple-tools_0.8.0_1787746049599_0.3094164147001326","host":"s3://npm-registry-packages-npm-production"}},"0.9.0":{"pi":{"skills":[".pi/skills/apple-tools"]},"_id":"@blackbelt-technology/pi-dashboard-apple-tools@0.9.0","bin":{"pi-apple-tools-install":"src/bin/install.ts"},"bugs":{"url":"https://github.com/BlackBeltTechnology/pi-agent-dashboard/issues"},"dist":{"shasum":"4ed19b6414caba0b24e57cb644ab9e4179f85cb4","tarball":"https://registry.npmjs.org/@blackbelt-technology/pi-dashboard-apple-tools/-/pi-dashboard-apple-tools-0.9.0.tgz","fileCount":12,"integrity":"sha512-QgvAmsXvNR1kG1uzqgIpMhaMdklCXV4NXPeJXkLPLb8wBOyFOGOHvBoX+jSHFww4CKwZkwvAH5xl9CAH2W7VUQ==","signatures":[{"sig":"MEUCIQDx0LuT8vXrEWFRNdzsrhNOAQ/oSphw4wapqPStKfIIlwIgQxxM+mapJM3+IwkDnUm1XB5wMZkn7O0FXOtu7bdA4cc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCact0dn99RIukKu7jpfeLbbJeF3qwqno+W1UcBnYpBigIhAN9kFqwTqSOHAixGVBH7cv3v8hiBXZJO4mDvl9yqlIZL"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blackbelt-technology%2fpi-dashboard-apple-tools@0.9.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":43479},"name":"@blackbelt-technology/pi-dashboard-apple-tools","type":"module","exports":{".":{"types":"./src/client/index.tsx","default":"./src/client/index.tsx"},"./client":{"types":"./src/client/index.tsx","default":"./src/client/index.tsx"},"./server":{"types":"./src/server/index.ts","default":"./src/server/index.ts"}},"gitHead":"60a155465d55e4438e1425c07b0ab5459083a9b5","license":"MIT","version":"0.9.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"a18c8013-6354-4093-b403-35e8e3e85a98"}},"homepage":"https://github.com/BlackBeltTechnology/pi-agent-dashboard#readme","keywords":["pi","pi-dashboard-plugin","imcp","mcp","apple","calendar","contacts","reminders","macos"],"repository":{"url":"git+https://github.com/BlackBeltTechnology/pi-agent-dashboard.git","type":"git","directory":"packages/apple-tools"},"_npmVersion":"12.2.0","description":"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.","directories":{},"maintainers":[{"name":"mbotond","email":"botond.molnar@blackbelt.hu"},{"name":"mrbence","email":"dbence10@gmail.com"},{"name":"robertcsakany","email":"robert.csakany@blackbelt.hu"},{"name":"norbert.herczeg","email":"norbert.herczeg@blackbelt.hu"}],"_nodeVersion":"24.21.0","dependencies":{"@blackbelt-technology/pi-dashboard-shared":"^0.9.0","@blackbelt-technology/dashboard-plugin-runtime":"^0.9.0","@blackbelt-technology/pi-dashboard-mcp-client-plugin":"^0.9.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"react":"^19.0.0","react-dom":"^19.0.0","@types/react":"^19.0.0","@types/react-dom":"^19.0.0"},"peerDependencies":{"react":">=18.0.0","react-dom":">=18.0.0"},"pi-dashboard-plugin":{"id":"apple-tools","claims":[{"slot":"settings-section","component":"AppleToolsSettings"}],"client":"./src/client/index.tsx","server":"./src/server/index.ts","priority":100,"requires":{"paths":["${imcpServerPath}"]},"dependsOn":["mcp-client"],"displayName":"Apple Tools","configSchema":"./config.schema.json"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-dashboard-apple-tools_0.9.0_1791297158753_0.4907079057453647"}}},"time":{"created":"2026-08-17T20:15:47.191Z","modified":"2026-10-06T14:32:39.323Z","0.7.0":"2026-08-17T20:15:47.568Z","0.8.0":"2026-08-26T12:07:29.745Z","0.9.0":"2026-10-06T14:32:38.826Z"},"bugs":{"url":"https://github.com/BlackBeltTechnology/pi-agent-dashboard/issues"},"license":"MIT","homepage":"https://github.com/BlackBeltTechnology/pi-agent-dashboard#readme","keywords":["pi","pi-dashboard-plugin","imcp","mcp","apple","calendar","contacts","reminders","macos"],"repository":{"url":"git+https://github.com/BlackBeltTechnology/pi-agent-dashboard.git","type":"git","directory":"packages/apple-tools"},"description":"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.","maintainers":[{"name":"mbotond","email":"botond.molnar@blackbelt.hu"},{"name":"mrbence","email":"dbence10@gmail.com"},{"name":"robertcsakany","email":"robert.csakany@blackbelt.hu"},{"name":"norbert.herczeg","email":"norbert.herczeg@blackbelt.hu"}],"readme":"# @blackbelt-technology/pi-dashboard-apple-tools\n\nProvision and surface **iMCP** — Apple PIM (Calendar, Contacts, Reminders,\nMessages, Location, Maps, Weather) — for a pi session on **macOS**, reached\nthrough pi's **built-in MCP** (pi ≥ 1.0.0). No `pi-mcp-adapter`.\n\n> **macOS only. No Apple Mail.** iMCP exposes no Mail service; \"Messages\" is\n> iMessage/SMS, not email. For email use the `apple-mail-fast-export` skill.\n\n## What it does\n\nThree moving parts must line up before a single Apple tool call works:\n\n1. **iMCP.app installed** — `brew install --cask mattt/tap/iMCP`\n2. **`mcp.json` entry present** — `mcpServers.iMCP.command` in `~/.pi/agent/mcp.json`\n3. **TCC grants** — **manual**, in the iMCP menu-bar app (Apple's security model\n   has no API; this step cannot be automated)\n\nSteps 1–2 are automated by this package. Step 3 is a documented manual click.\n\n## Install\n\n```bash\npi install npm:@blackbelt-technology/pi-dashboard-apple-tools\n```\n\nInstalling the package does nothing on its own (no `postinstall`). Provisioning\nis **opt-in**:\n\n```bash\npi-apple-tools-install          # provision (writes mcp.json only)\npi-apple-tools-install --check  # report the state without changing anything\n```\n\n## Provisioning states\n\nA closed nine-member enum, identical across the CLI, the dashboard panel, and\nthe `doctor` probe:\n\n`UNSUPPORTED_PLATFORM` · `OS_VERSION_UNKNOWN` · `OS_TOO_OLD` ·\n`NO_INSTALL_METHOD` · `INSTALL_FAILED` · `CONFIG_UNPARSEABLE` ·\n`CONFIG_WRITE_FAILED` · `READY_PENDING_GRANTS` · `READY`\n\n`READY_PENDING_GRANTS` means everything is wired but you still need to grant\npermissions in the iMCP menu-bar app. `READY` is a live round trip through pi's\nbuilt-in MCP, never the provisioning traversal. Minimum macOS: **15.3**.\n\n## Manual grant step\n\nAfter `READY_PENDING_GRANTS`, open the **iMCP menu-bar app** and grant each Apple\nservice you need. Grants can be **revoked out of band** at any time and cannot be\ndetected ahead of a call — a permission-class failure means **menu-bar\nremediation**, not re-running the installer.\n\n## Dashboard panel\n\nThe plugin contributes a settings section under its own row in the Plugins tab:\nstatus readout (`exposure`, `enabled`), **Run installer**, and the\n`imcp-server` path override. Server enable/disable and exposure live in the\n**mcp-client** plugin (Settings → MCP); the panel links there. It has **no\nper-service toggles** — those are menu-bar only.\n\niMCP tools are reached as `mcp__iMCP__*` per the entry's `exposure` (`codemode`\nby default; `deferred` via `tool_search`). Operator-set `enabled` / `exposure` /\n`toolExposure` and unknown keys are preserved on refresh; only `command` is\nrewritten.\n","readmeFilename":"README.md"}