Baïkal (CalDAV)

From its catalog listing

Read, search and (opt-in) edit events and todos on a Baïkal or other CalDAV server, with recurrence expansion and free/busy.

Good to know before installing

sends every request to the https URL in BAIKAL_CALDAV_URL (plain http only for localhost) with BAIKAL_USERNAME and BAIKAL_PASSWORD read through Hermes, follows no redirects and ignores proxy variables; only the six read tools register unless the plugin setting allow_write is true, and with it the agent can create, change, complete and permanently delete events and todos, visible to everyone sharing those calendars; the tools are offered on every surface where the baikal toolset is enabled, gateways included, so anyone allowed on your gateway reads your calendar; event text written by other people reaches the agent as tool output; no other endpoint, no telemetry, no file or shell access, no background process. Independent community plugin, not affiliated with Baïkal or sabre/dav.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs (this one needs BAIKAL_CALDAV_URL, BAIKAL_USERNAME, BAIKAL_PASSWORD), then asks whether to turn it on.
    hermes plugins install hermes-baikal
  2. Said no? Turn it on later:
    hermes plugins enable hermes-baikal
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Web, research & browsing
Maintained by
tedlefter (Community)
Needs
BAIKAL_CALDAV_URL BAIKAL_USERNAME BAIKAL_PASSWORD API keys
Adds tools
baikal_list_calendars baikal_list_events baikal_get_event baikal_list_todos baikal_get_todo baikal_free_busy baikal_create_event baikal_update_event baikal_delete_event baikal_create_todo baikal_update_todo baikal_complete_todo baikal_delete_todo
Needs Hermes
0.23.1 or newer
Version
0.2.0
In the catalog
2026-11-17

Known issues (from its catalog listing)

  • Write tools (create, update, complete, delete) register only after `hermes config set plugins.entries.hermes-baikal.settings.allow_write true` and a new session
  • When the server cannot expand recurring events (Baïkal returns HTTP 500 if a calendar's calendar-timezone is a bare TZID, which its web admin sets), the plugin expands them itself; rules using BYSETPOS, BYWEEKNO, BYYEARDAY or sub-daily frequencies come back as the stored series with an expand_error note
  • Events with per-occurrence overrides can be read but not edited, editing a recurring event changes the whole series, and completing a recurring todo is refused
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in web, research & browsing

All web, research & browsing plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins