https://github.com/thiswillbeyourgithub/home-assistant-caldav-client
A CalDAV client for automating task management with Home Assistant, Nextcloud, and voice commands.
https://github.com/thiswillbeyourgithub/home-assistant-caldav-client
Last synced: 5 months ago
JSON representation
A CalDAV client for automating task management with Home Assistant, Nextcloud, and voice commands.
- Host: GitHub
- URL: https://github.com/thiswillbeyourgithub/home-assistant-caldav-client
- Owner: thiswillbeyourgithub
- License: gpl-3.0
- Created: 2025-10-06T10:21:36.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-10-06T12:28:27.000Z (5 months ago)
- Last Synced: 2025-10-06T12:34:32.929Z (5 months ago)
- Language: Python
- Size: 36.1 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Home Assistant CalDAV client
Work in progress: this is a simple setup to handle caldav from home assistant via a `service`.
I created the python package [CalDAV-Tasks-API](https://github.com/thiswillbeyourgithub/Caldav-Tasks-API) and wanted to use the `Voice Assistant` to create task. Something like `Okay Nabu. I have to do the dishes` and have it automatically added to my TODO lists. That lists being part of my Nextcloud [Tasks](https://apps.nextcloud.com/apps/tasks) app, which uses caldav so is synced on my phone to [Tasks.org](https://github.com/tasks/tasks/).
## How to
0. Have a Home Assistant instance.
1. Install [HACS](https://www.hacs.xyz/).
2. Use HACS to install [pyscript](https://hacs-pyscript.readthedocs.io/).
3. Have a way to access Home Assistant's files. I use [addon-ssh](https://github.com/hassio-addons/addon-ssh).
4. *Not sure this is needed:* add to `/root/homeassistant/configuration.yaml`:
```yaml
pyscript:
allow_all_imports: true
hass_is_global: true
```
5. Create the folder `/config/pyscript`
6. Inside that `pyscript` folder, add the `requirements.txt` file (this will install my package [CalDAV-Tasks-API](https://github.com/thiswillbeyourgithub/Caldav-Tasks-API)). Same for `caldav.py`. You can add a `caldav_password.secret` text file containing your password to avoid hardcoding it in the Web UI.
6. Restart Home Assistant (might not be needed but just to be safe)
### Testing everything works
1. Open Home Assistant > `Settings` > `Automations & scenes` > `Create automation` > `Create new automation` > `Add action` > search for `caldav_add`.
2. Fill in the values then click on the [kebab menu](https://kagi.com/proxy/images?c=_m3km2RjA3G0qleowsZXHZb9NEn0fSsEYIHbKzMDyAFb4nUPIanknmQV_g0rmdCI7DSE22WJPm02DVRa5zIwCPC41lLGjxK0i-EQl5d8ksDTc5kbYP4yXvylNyvKQ4EQWuBHN6v0-pHv23WJZriDSg%3D%3D) then `Run action`.
3. In the Home Assistant shell, `cat /root/homeassistant/homeassistant.log` to look for any issues.
### Giving access to LLMs
I'm so far using [Extended OpenAI Conversation](https://github.com/jekalmin/extended_openai_conversation).
To give access to caldav to your LLM, modify the hardcoded values at the bottom of the file `function_spec.yaml` then paste it in the `Functions` section of the config of `Extended OpenAI Conversation`.
## Notes
- Feedbacks welcome
- I didn't create `intents` or things like that because I use LLMs directly