ChatGPTClaudeGrok / X / CursorGemini

icloud-calendar-plugin: Give DeepSeek Harness Access to China iCloud Calendars and Contacts

srt180/icloud-calendar-plugin

Integrations & ConnectionsVerified
Listed on 2026-11-20
Page last updated 2026-11-20

Connects China-region iCloud Calendar and Contacts to DeepSeek Harness, letting the agent list calendars, find, create, update and delete events, and look up contacts over CalDAV/CardDAV.

icloud-calendar-plugin is a DSH plugin that connects China-region Apple ID calendars and contacts to DeepSeek Harness, letting the assistant query and modify that data directly. It reaches the China domains over CalDAV and CardDAV with automatic fallback to the global domains, so both China and global accounts work, and it does not rely on the local calendar app. Core abilities include listing calendars, finding events by time window or keyword, creating and partially updating events, cancelling a single occurrence of a recurring event, and searching read-only contacts by Chinese name, pinyin initials or phone.

How to Install

install
dsh plugin --profile <your-profile> add github:srt180/icloud-calendar-plugin

Replace --profile with the profile name you actually run (see ls ~/.dsh/profiles/): usually web in the browser UI, desktop or desktop-NNN in the desktop app.

Category
Integrations & Connections
Platform
DSH Plugin
Author
srt180
Distribution
Plugin

icloud-calendar-plugin Key Features

List calendars and permissionsFind events by time and keywordCreate, update, delete eventsExpand and cancel recurring instancesLook up contacts by name or pinyin
Listed on dsh-plugin.org

icloud-calendar-plugin Repo Summary

What Does It Do?

It is a DSH plugin for DeepSeek Harness that gives the agent read and write access to iCloud calendars and contacts for China-region Apple IDs. It solves the problem that China-region iCloud data (stored on GCBD servers) cannot otherwise be reached by an agent inside the harness, connecting over CalDAV/CardDAV to caldav.icloud.com.cn and contacts.icloud.com.cn with automatic fallback to the global domains, so both China and global accounts work. The plugin does not rely on the local Calendar.app or read the local calendar database, is pure ESM with no runtime dependencies, and is maintained by srt180 under the MIT license.

Core Features

  • Calendar and event discovery: list calendars with colors, read/write permissions and the default target calendar, and find events by time window, common ranges or keyword, expanding recurring events occurrence by occurrence.
  • Event create, update and delete: create events with title, start/end, all-day flag, location, notes, recurrence rules, advance alarms and attendees; updates change only the supplied fields while keeping everything else, including existing alarms; deletion removes a whole event or cancels a single occurrence of a recurring one.
  • Chinese-aware contact lookup: search iCloud contacts by Chinese name, pinyin, pinyin initials (zw matches 张伟), email, company or phone; contacts are read-only.
  • China time zone handling: times are interpreted and displayed in Asia/Shanghai by default with a +08:00 offset, and the zone is configurable to any IANA name.
  • Safe writes and credential protection: writes carry ETags and refuse to overwrite when another device changed the event; the Apple ID password is never written to config files, and credentials live in the DSH credential store, re-read on every call.

How to Use This Plugin?

After enabling it in DSH, configure the account first: generate an app-specific password (not the Apple ID login password), then either hand the Apple ID and password to the assistant in a session to store, or write them directly into the icloud-calendar/default record of the DSH credential store. Verify by asking the assistant to list your iCloud calendars; the reply shows the calendar count, time zone and default write target. Day to day, just use natural language, such as finding events in a date range, creating a meeting with an alarm, changing a location, or cancelling one occurrence of a recurring event. For multiple accounts, a proxy or a different timeout, set the non-sensitive account, proxy and timeoutMs fields in the plugin config.

How to Troubleshoot This Plugin?

  • The server returns 412 on a write: another device modified the event in the meantime, so the plugin refuses to overwrite; re-read the event and retry.
  • The account cannot connect or authenticate: confirm two-factor authentication is enabled and that an app-specific password is used instead of the login password; disabled accounts or those without app-specific password support cannot be used.
  • Requests to iCloud time out: Node's https does not read system proxy settings, so fill in the proxy field when access must go through an HTTP proxy.
  • Recurring events return only the master event: complex rules such as BYSETPOS or BYMONTHDAY are not expanded approximately, which is a known limitation.

This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: srt180/icloud-calendar-plugin. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.

Install, update, and uninstall this plugin in the Plugin Market of DeepSeek Harness's DSH Plugin Hub
ChatGPTClaudeGrok / X / CursorGemini

DSH Plugin FAQ