{"_id":"@brigid/mcp-apple-calendar","name":"@brigid/mcp-apple-calendar","dist-tags":{"latest":"0.0.3"},"versions":{"0.0.3":{"name":"@brigid/mcp-apple-calendar","version":"0.0.3","description":"Read-only Apple Calendar MCP server (via macOS EventKit) — the reference implementation of brigid's calendar capability contract.","license":"MIT","type":"module","main":"./src/index.js","types":"./src/index.d.ts","bin":{"mcp-apple-calendar":"src/bin.js"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^4.4.3"},"module":"./src/index.js","_id":"@brigid/mcp-apple-calendar@0.0.3","_integrity":"sha512-Gk9O7hQRjPVCuEWns73Wd/z2YxFKZ2kQvxXgAJtqr+7qbCBAzQ+K0Y4HMWGEFVbV2IpIuGl7mHT6wk0dOsbNkw==","_resolved":"/private/var/folders/_n/l7mcb1_j7ls5hzy52nhbb65m0000gn/T/f334b278e04936098ce34be9b04f322b/brigid-mcp-apple-calendar-0.0.3.tgz","_from":"file:brigid-mcp-apple-calendar-0.0.3.tgz","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-Gk9O7hQRjPVCuEWns73Wd/z2YxFKZ2kQvxXgAJtqr+7qbCBAzQ+K0Y4HMWGEFVbV2IpIuGl7mHT6wk0dOsbNkw==","shasum":"12fd8547919347d4bf23925254d6858a0b303f00","tarball":"https://registry.npmjs.org/@brigid/mcp-apple-calendar/-/mcp-apple-calendar-0.0.3.tgz","fileCount":16,"unpackedSize":19839,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDGbGEedgWA5r9uUNr48IPA3mo2ACd/hoscYRgIyWNDZQIgOEhP0H8kNlCBH3qA9BGTqb103rH/vmQjLYOrm69wdEw="}]},"_npmUser":{"name":"shadowgate15","email":"taylorschley@me.com"},"directories":{},"maintainers":[{"name":"shadowgate15","email":"taylorschley@me.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-apple-calendar_0.0.3_1783395164380_0.4840034561720554"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-07T03:32:44.226Z","0.0.3":"2026-07-07T03:32:44.510Z","modified":"2026-07-07T03:32:44.733Z"},"maintainers":[{"name":"shadowgate15","email":"taylorschley@me.com"}],"description":"Read-only Apple Calendar MCP server (via macOS EventKit) — the reference implementation of brigid's calendar capability contract.","license":"MIT","readme":"# @brigid/mcp-apple-calendar\n\nA read-only Apple Calendar [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server.\nIt is the **reference implementation** of brigid's\n[calendar capability contract](../../docs/contracts/calendar.md) — it exposes only the tool the\nbrigid GTD skills need (`find-events`), using the contract's canonical tool name so the skills\ndetect and use it automatically.\n\n**macOS only.** It reads Apple Calendar via macOS **EventKit** — the same store `Calendar.app`\nshows, so it sees every account you've added there (iCloud, Google, Exchange, …). See\n[ADR 0002](../../docs/adr/0002-calendar-connector-eventkit-reference.md) for why.\n\n## Conformance\n\n| Capability group                    | Status         |\n| ----------------------------------- | -------------- |\n| **Core** (`find-events`, read-only) | ✅ implemented |\n\nWrite (event creation/moves) is intentionally out of scope for v1 — see the contract and ADR 0002.\n\n## Permissions\n\nNo API token or configuration is needed. The first time `find-events` runs, macOS will prompt you\nto grant Calendar access to whatever process is invoking the server; grant it in the dialog, or\nafter the fact via **System Settings → Privacy & Security → Calendars**. Access persists across\nruns once granted.\n\nIf access is denied, not yet granted, or the prompt times out, `find-events` returns an explicit\ntool error — it never reports an empty calendar as a way of papering over a permission problem.\n\n## Structure\n\n- `src/index.ts` — `createServer()`, the reusable/testable server factory (registers `find-events`, no transport).\n- `src/bin.ts` — the executable entry (`bin`), which attaches the stdio transport and runs the server.\n- `src/eventkit.ts` — the Node-side bridge to the native shim; translates its output into the contract's `Event` shape.\n- `src/native/find-events.jxa.js` — the JXA (JavaScript for Automation) script that bridges into macOS EventKit. Not compiled by tsc; copied to `dist` as a build asset.\n\n## Develop\n\n```sh\nnx build mcp-apple-calendar        # compile to dist/packages/mcp-apple-calendar\nnx lint mcp-apple-calendar --fix    # lint + sync package.json deps from the root (single-version policy)\n```\n\n## Run\n\nAfter building, launch the server over stdio (macOS only):\n\n```sh\nnode dist/packages/mcp-apple-calendar/src/bin.js\n```\n\nOr, once published, via `npx @brigid/mcp-apple-calendar`.\n\n🚀\n","readmeFilename":"README.md","_rev":"1-febf6446572d7328fd9df3cd8ea1044d"}