Calendar.app

NPM · @P-L-TA/CALENDAR-MCP · SCANNED AUG 4

List, search, and manage calendar events via macOS Calendar.app across all configured accounts.

Available components

+23 this week 69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 87 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability76

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 838 tokens (~119/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage97

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
92% of tool parameters carry a description.Partial

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @p-l-ta/calendar-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add p-l-ta-calendar-mcp -- npx -y @p-l-ta/calendar-mcp

# add to Codex CLI

codex mcp add p-l-ta-calendar-mcp -- npx -y @p-l-ta/calendar-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "p-l-ta-calendar-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@p-l-ta/calendar-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add p-l-ta-calendar-mcp --command npx --arg -y --arg @p-l-ta/calendar-mcp

# ~/.hermes/config.yaml

mcp_servers:
  p-l-ta-calendar-mcp:
    command: "npx"
    args: ["-y", "@p-l-ta/calendar-mcp"]

// mcp.json

{
  "mcpServers": {
    "p-l-ta-calendar-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@p-l-ta/calendar-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

4 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +60
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Security disclosure: fail → unverified ▼ functional
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 −15
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
31 Jul 26 −26
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
27 Jul 26 46

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@p-l-ta/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 7 exposed · ~838 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

create_event ~200

Create a new event in Calendar.app. Goes through AppleScript so Calendar.app syncs the new event to all connected accounts. Returns the uid of the created event.

Input Output Examples

Name	Type	Req	Description
all_day	boolean	—	True for an all-day event. When true, start/end times are ignored — only the dates are used.
calendar	string	yes	Name of the target calendar (e.g. 'Calendar', 'Work'). Must match an existing calendar name exactly.
description	string	—	Event notes/body.
end	string	yes	ISO 8601 end datetime, e.g. '2026-05-10T10:00:00'.
location	string	—	Location string.
start	string	yes	ISO 8601 start datetime, e.g. '2026-05-10T09:00:00'.
summary	string	yes	Event title.
url	string	—	URL to attach to the event.

No output schema declared.

No examples provided.

delete_event ~69

Permanently delete a Calendar.app event identified by its uid. Goes through AppleScript so the deletion syncs to all connected accounts. This action cannot be undone.

Input Output Examples

Name	Type	Req	Description
uid	string	yes	The iCal uid of the event to delete (uid field from list_events, search_events, or get_event).

No output schema declared.

No examples provided.

get_event ~69

Get full details of a single Calendar.app event by UUID, including attendees and all metadata. The uuid field is returned by list_events and search_events.

Input Output Examples

Name	Type	Req	Description
uuid	string	yes	The event UUID (or iCal unique_identifier) returned by list_events, search_events, or a prior get_event call.

No output schema declared.

No examples provided.

list_calendars ~50

List all Calendar.app calendars across all accounts, with name, UUID, color, and account info. UUIDs can be passed to list_events, search_events, and get_event to filter by calendar.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_events ~158

List calendar events within a date range. Queries the Calendar.app SQLite database via OccurrenceCache, which correctly expands recurring event instances rather than just listing master events. Returns events sorted by start time.

Input Output Examples

Name	Type	Req	Description
calendar_uuid	string	—	Restrict results to a single calendar. Pass a UUID from list_calendars.
end	string	yes	ISO 8601 end of the window (exclusive). Events whose occurrence starts before this time are included.
limit	integer	—	—
start	string	yes	ISO 8601 start of the window, e.g. '2026-05-01T00:00:00' or '2026-05-01'. Events whose occurrence starts on or after this time are included.

No output schema declared.

No examples provided.

search_events ~138

Search Calendar.app events by text across title, description, and location. Queries CalendarItem directly for fast full-text matching. For recurring events returns the master event; use list_events for occurrence-level detail.

Input Output Examples

Name	Type	Req	Description
calendar_uuid	string	—	Restrict results to a single calendar. Pass a UUID from list_calendars.
end	string	—	ISO 8601 date — only events starting before this date.
limit	integer	—	—
query	string	yes	Text to search for in event title, description, and location.
start	string	—	ISO 8601 date — only events starting on or after this date.

No output schema declared.

No examples provided.

update_event ~154

Update properties of an existing Calendar.app event identified by its uid. Only provided fields are changed. Goes through AppleScript so changes sync to all connected accounts.

Input Output Examples

Name	Type	Req	Description
description	string	—	New event notes/body. Pass empty string to clear.
end	string	—	New ISO 8601 end datetime.
location	string	—	New location string. Pass empty string to clear.
start	string	—	New ISO 8601 start datetime.
summary	string	—	New event title.
uid	string	yes	The iCal uid of the event to update (uid field from list_events, search_events, or get_event).
url	string	—	New URL. Pass empty string to clear.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 4 Aug