# Event Read: Hermes Agent plugin

> Read one CalDAV calendar collection you run, with list_events and read_event.

Canonical: https://hermeswatcher.com/plugins/event-read  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/event-read  
Last updated in catalog: 2026-10-13

Read one CalDAV calendar collection you run, with list_events and read_event.

## Good to know before installing

Sends CALDAV_USER and CALDAV_PASSWORD as Basic auth to your CALDAV_URL, does not follow redirects, and starts no local program. Over plain http that password travels unencrypted. The tools are on for every surface, including gateways, and the plugin has no user list of its own: anyone you allow on your Hermes gateway reads the calendar with your password. Turn a surface off with hermes tools. A watch is a cron job you create yourself with hermes cron create. Each run is at least one model turn, there is no daily cap, and the job stays until you run hermes cron remove. Under plugins.isolation: host the watch cannot run and posts a notice saying so on every run. When the watch can run, it reports a problem on the first run, when the cause changes and again after 23 hours, or on every run when its data directory cannot be written. Each request gives up after 20 seconds without data, and a whole call has no time limit. The watch relies on private parts of Hermes, so an update can stop it. State lives in plugin-data/event-read. Not tested against a vendor-hosted calendar.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs (this one needs `CALDAV_URL`, `CALDAV_USER`, `CALDAV_PASSWORD`), then asks whether to turn it on.

```bash
hermes plugins install event-read
```

2. Said no? Turn it on later:

```bash
hermes plugins enable event-read
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Work & business
- Maintained by: TakeshiTGAL (Community)
- Needs: `CALDAV_URL`, `CALDAV_USER`, `CALDAV_PASSWORD` (API keys)
- Adds tools: `list_events`, `read_event`
- Requires Hermes: `>=0.21.4`
- Version: 0.1.0
- In the catalog since: 2026-10-13

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/event-read)
- [Source code](https://github.com/TakeshiTGAL/hermes-plugin-event-read#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt