mcp-ical-swift
MCP server for Apple Calendar using compiled Swift to bypass macOS Sequoia TCC restrictions
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
Sealjay
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
ical__list_calendarsList all Apple Calendar calendars accessible to the host process. Returns a JSON array of `{name, uid, type}` objects; `name` is the human-readable label other tools accept as their `calendar` parameter (collisions across accounts are possible — first match wins). Read-only; requires macOS Calendar …
ical__list_eventsList calendar events within an inclusive date range (capped at 90 days). Returns a JSON array of `{title, start, end, allDay, calendar, uid, location?, notes?}`; use `ical__search_events` for keyword queries and `ical__get_event` for full details on one event. Read-only; requires macOS Calendar acce…
ical__search_eventsFind upcoming calendar events whose title, location, or notes contain a case-insensitive substring. Returns a JSON array of `{title, start, end, calendar, uid, location?, notes?}`; use `ical__list_events` when you have a specific date range. Read-only; requires macOS Calendar access.
ical__create_eventCreate a new calendar event in EventKit; visible in Apple Calendar.app and synced via iCloud if the chosen calendar is iCloud-backed. Returns `{uid, title, status: 'created'}`; reversible via `ical__delete_event` using the returned UID. Requires `ICAL_ALLOW_WRITE=true` and macOS Calendar access for …
ical__update_eventUpdate fields on a single existing calendar event; only fields you provide are changed. For recurring events this modifies the single occurrence only (EventKit `.thisEvent` span), not the series. Returns `{uid, title, status: 'updated'}`; not automatically reversible — capture prior values via `ical…
ical__get_eventGet full details of a single calendar event by UID. Returns `{uid, title, start, end, allDay, calendar, location?, notes?, url?, hasRecurrence?}`; use `ical__list_events` or `ical__search_events` for bulk queries. Read-only; requires macOS Calendar access.
ical__delete_eventDelete a single calendar event by UID; for recurring events this removes the single occurrence only (EventKit `.thisEvent` span), not the series. Destructive: removal propagates to iCloud if the calendar is iCloud-backed and is not reversible from this server (capture details with `ical__get_event` …
ICAL_ALLOW_WRITECreate, update, and delete events (opt-in via =true)All four hints declared on every tool
4/7 tools missing one or more hints — ical__list_calendars (missing: destructiveHint, idempotentHint); ical__list_events (missing: destructiveHint, idempotentHint); ical__search_events (missing: destructiveHint, idempotentHint), +1 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Tool annotations match behaviour
4 read-only tools perform write/delete/exec — ical__list_calendars (line 28: execFileSync(BINARY, [command, ...args], {); ical__list_events (line 28: execFileSync(BINARY, [command, ...args], {); ical__search_events (line 28: execFileSync(BINARY, [command, ...args], {)
Either remove the readOnlyHint:true annotation, or remove the write/delete call from the tool handler.
Descriptions match behaviour
1 tool describes read intent but its handler mutates — ical__list_calendars (line 28: execFileSync(BINARY, [command, ...args], {)
Rename the tool, rewrite the description, or move the side-effect into a separate clearly-named tool.
Tool inputs are validated
6/7 tool handlers declare input schemas (86%)
Declare an inputSchema with zod/joi/yup on every tool definition.
License file
No license file
Add a LICENSE file (MIT, Apache-2.0, etc.).
Tool test coverage
Only 0/7 tools referenced in tests (0%)
Write tests that reference each tool by name so every tool has at least one test.
Tool description accuracy
4 tools have description/behavior mismatches: ical__list_calendars: description implies read-only but handler writes/deletes/executes; ical__list_events: description implies read-only but handler writes/deletes/executes; ical__search_events: description implies read-only but handler writes/deletes/executes
Update tool descriptions to accurately reflect all capabilities — especially write, delete, or execute operations.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/sealjay/mcp-ical-swift)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check