dsh-macos-calendar
A host-side plugin for DeepSeek Harness (DSH) that gives agents real
macOS Calendar integration: create, list, query and delete events in the
Apple Calendar app through AppleScript (EventKit automation).
Unlike in-GUI calendar plugins (e.g. MAGMA27/dsh-calendar, which schedules
Agent runs inside the DSH web UI), this plugin writes real system calendar
events — they sync to iCloud and appear in Calendar on all your devices.
Tools
| Tool | Description |
|---|
calendar_list | List all calendar names (read-only) |
calendar_add | Create an event: title, start/end YYYY-MM-DD HH:MM, calendar, notes, alert_minutes |
calendar_events | List events of a calendar for the next N days (read-only) |
calendar_delete | Delete events whose summary contains a title (pass from to protect old events) |
Usage in any DSH session: just ask "add a calendar event on ..." — the agent
calls the tools directly. The tools run inside the dsh web host process, so no
per-session approval is needed once the macOS automation permission is granted.
Install
dsh plugin --profile web add /path/to/dsh-macos-calendar
# restart dsh web
Requires Node >= 22, macOS, and Automation permission for the host process
(System Settings → Privacy & Security → Automation → allow the dsh host to
control Calendar). The permission prompt appears on the first osascript call.
Notes for plugin authors (Cordis 4)
This plugin consumed ctx.tools and initially crashed the whole dsh web with
cannot get property "tools" without inject (231 crash-loop restarts). Cordis 4
requires every consumed service to be declared:
export const inject = ['tools'] // module export form
apply.inject = ['tools'] // function-property form (loader reads this)
Keep both forms so the include loader resolves the dependency regardless of
which form it reads.
AppleScript date strings depend on the system locale (an ISO string was parsed
as year 12194 in testing) — always construct dates via date components
(set year/month/day/hours/minutes of d to ...), which is locale-independent.
License
MIT
Development
npm test # unit tests (node:test, zero deps)
See TROUBLESHOOTING.md for permission and osascript
failure diagnosis.
