用 Google 行事曆觸發家裡的自動化（完整設定）

charles

行事曆是一個被低估的觸發來源。

它知道你「明天要早起」「今天有客人來」「下週要出差」——
這些資訊沒有任何感測器抓得到。



先接進來

設定 → 裝置與服務 → 新增整合 → Google Calendar

設定步驟：

• 需要 Google Cloud 專案和 OAuth 憑證
  
• HA 的文件有詳細步驟（大概十分鐘）
  
• 授權之後會問你要匯入哪些行事曆
  

重點：建立專用的行事曆

不要用你的主行事曆當觸發來源。

理由：

• 主行事曆有一堆不相關的活動
  
• 會員工作行程混在一起
  
• 隱私（HA 會讀取活動標題）
  

在 Google 行事曆裡新建一個叫「家」的行事曆，
專門放要觸發自動化的事件。

觸發器怎麼寫

HA 的行事曆觸發器有兩種：

1. triggers:
2.   # 活動開始時
3.   - trigger: calendar
4.     entity_id: calendar.家
5.     event: start
6.     offset: "-00:30:00"       # 提前 30 分鐘
8.   # 活動結束時
9.   - trigger: calendar
10.     entity_id: calendar.家
11.     event: end
12.     offset: "00:00:00"

複製代碼

offset 可以是負的（提前）或正的（延後）。

用活動標題分流

一個行事曆可以放各種事件，用標題來分：

1. alias: 行事曆自動化總處理
2. id: calendar_dispatcher
4. triggers:
5.   - trigger: calendar
6.     entity_id: calendar.家
7.     event: start
8.     id: 開始
9.   - trigger: calendar
10.     entity_id: calendar.家
11.     event: end
12.     id: 結束
14. actions:
15.   - variables:
16.       標題: "{{ trigger.calendar_event.summary }}"
17.       描述: "{{ trigger.calendar_event.description | default('') }}"
19.   - choose:
20.       # --- 有客人來 ---
21.       - conditions:
22.           - condition: trigger
23.             id: 開始
24.           - "{{ '客人' in 標題 or '訪客' in 標題 }}"
25.         sequence:
26.           - action: scene.turn_on
27.             target: {entity_id: scene.訪客模式}
28.           - action: camera.turn_off
29.             target: {entity_id: camera.客廳}      # 隱私
30.           - action: script.smart_announce
31.             data:
32.               area: all
33.               message: 訪客模式已啟動
35.       # --- 出差 / 旅行 ---
36.       - conditions:
37.           - condition: trigger
38.             id: 開始
39.           - "{{ '出差' in 標題 or '旅行' in 標題 }}"
40.         sequence:
41.           - action: input_select.select_option
42.             target: {entity_id: input_select.house_mode}
43.             data: {option: 度假}
45.       - conditions:
46.           - condition: trigger
47.             id: 結束
48.           - "{{ '出差' in 標題 or '旅行' in 標題 }}"
49.         sequence:
50.           - action: input_select.select_option
51.             target: {entity_id: input_select.house_mode}
52.             data: {option: 在家-日間}
53.           - action: climate.set_temperature
54.             target: {entity_id: climate.主臥}
55.             data: {temperature: 26, hvac_mode: cool}   # 提前降溫
57.       # --- 早班（提前 30 分鐘觸發） ---
58.       - conditions:
59.           - condition: trigger
60.             id: 開始
61.           - "{{ '早班' in 標題 }}"
62.         sequence:
63.           - action: input_datetime.set_datetime
64.             target: {entity_id: input_datetime.鬧鐘時間}
65.             data:
66.               time: >
67.                 {{ (trigger.calendar_event.start | as_datetime
68.                     - timedelta(hours=1, minutes=30)).strftime('%H:%M:%S') }}
70. mode: queued
71. max: 5

複製代碼

trigger.calendar_event 裡有什麼

1. {
2.   "summary": "客人來訪",
3.   "description": "王先生一家",
4.   "start": "2026-09-25T18:00:00+08:00",
5.   "end": "2026-09-25T21:00:00+08:00",
6.   "location": "家",
7.   "all_day": false
8. }

複製代碼

description 可以拿來放參數，這是一個好用的技巧：

1. # 行事曆活動的描述欄位填：
2. temp=24
3. lights=warm
5. # 自動化裡解析
6. - variables:
7.     設定: >
8.       {% set d = trigger.calendar_event.description | default('') %}
9.       {% set result = namespace(dict={}) %}
10.       {% for line in d.split('\n') %}
11.         {% if '=' in line %}
12.           {% set k, v = line.split('=', 1) %}
13.           {% set result.dict = dict(result.dict, **{k.strip(): v.strip()}) %}
14.         {% endif %}
15.       {% endfor %}
16.       {{ result.dict }}
18. - action: climate.set_temperature
19.   target: {entity_id: climate.客廳}
20.   data:
21.     temperature: "{{ 設定.temp | default(26) | int }}"

複製代碼

不用觸發器，直接查詢行事曆

有時候你不是要「活動開始時做事」，
而是要「判斷今天有沒有某個活動」。

行事曆實體的狀態：

• on —— 現在正在某個活動中
  
• off —— 現在沒有活動
  

屬性裡有：message、start_time、end_time、description、all_day。

1. conditions:
2.   - condition: state
3.     entity_id: calendar.家
4.     state: "on"
5.   - condition: template
6.     value_template: >
7.       {{ '在家工作' in state_attr('calendar.家', 'message') }}

複製代碼

查詢未來的活動（用服務）

1. - action: calendar.get_events
2.   target:
3.     entity_id: calendar.家
4.   data:
5.     start_date_time: "{{ today_at('00:00') }}"
6.     end_date_time: "{{ today_at('00:00') + timedelta(days=1) }}"
7.   response_variable: 今日活動
9. - action: notify.mobile_app_charles
10.   data:
11.     title: 今天的行程
12.     message: >
13.       {% set evs = 今日活動['calendar.家'].events %}
14.       {% if evs | count == 0 %}
15.       今天沒有安排
16.       {% else %}
17.       {% for e in evs %}
18.       {{ e.start[11:16] }} {{ e.summary }}
19.       {% endfor %}
20.       {% endif %}

複製代碼

response_variable 是比較新的功能，
讓服務可以回傳資料給後續步驟用。



五個實際好用的場景

1. 垃圾車提醒

在行事曆建一個週期性活動「倒垃圾」。

1. triggers:
2.   - trigger: calendar
3.     entity_id: calendar.家
4.     event: start
5.     offset: "-00:45:00"
6. conditions:
7.   - "{{ '垃圾' in trigger.calendar_event.summary }}"
8. actions:
9.   - action: script.smart_announce
10.     data:
11.       area: occupied
12.       message: 四十五分鐘後垃圾車會來，記得準備

複製代碼

2. 出差前的檢查

1. triggers:
2.   - trigger: calendar
3.     entity_id: calendar.家
4.     event: start
5.     offset: "-04:00:00"      # 提前四小時
6. conditions:
7.   - "{{ '出差' in trigger.calendar_event.summary }}"
8. actions:
9.   - action: notify.mobile_app_charles
10.     data:
11.       title: 出差前檢查
12.       message: >
13.         {% set problems = [] %}
14.         {% if states.light | selectattr('state','eq','on') | list | count > 0 %}
15.         有燈沒關。
16.         {% endif %}
17.         {% set low = states.sensor
18.            | selectattr('attributes.device_class','defined')
19.            | selectattr('attributes.device_class','eq','battery')
20.            | map(attribute='state') | map('int',100)
21.            | select('lt', 30) | list | count %}
22.         {% if low > 0 %}
23.         有 {{ low }} 個裝置電量低於 30%，建議先換電池。
24.         {% endif %}
25.         記得檢查冰箱、關窗、設定度假模式。

複製代碼

3. 在家工作日

1. conditions:
2.   - "{{ '在家工作' in trigger.calendar_event.summary }}"
3. actions:
4.   # 書房提前開冷氣和除濕
5.   - action: climate.set_temperature
6.     target: {entity_id: climate.書房}
7.     data: {temperature: 26, hvac_mode: cool}
8.   # 通知降級（工作時不要一直被打斷）
9.   - action: input_boolean.turn_on
10.     target: {entity_id: input_boolean.勿擾模式}

複製代碼

4. 小孩的課表

把課表放進行事曆，做「提醒帶什麼」：

1. message: >
2.   明天 {{ trigger.calendar_event.summary }}，
3.   {{ trigger.calendar_event.description }}

複製代碼

描述欄位填「記得帶直笛和體育服」。

5. 生日和紀念日

1. triggers:
2.   - trigger: time
3.     at: "08:00:00"
4. actions:
5.   - action: calendar.get_events
6.     target: {entity_id: calendar.紀念日}
7.     data:
8.       start_date_time: "{{ today_at('00:00') }}"
9.       end_date_time: "{{ today_at('00:00') + timedelta(days=1) }}"
10.     response_variable: 今日
11.   - condition: "{{ 今日['calendar.紀念日'].events | count > 0 }}"
12.   - action: script.smart_announce
13.     data:
14.       area: all
15.       message: >
16.         今天是{{ 今日['calendar.紀念日'].events[0].summary }}

複製代碼

注意事項

1. 同步延遲

Google Calendar 整合預設每 15 分鐘同步一次。

所以「臨時加一個五分鐘後開始的活動」可能不會觸發。

要立刻同步的話：

1. - action: homeassistant.update_entity
2.   target:
3.     entity_id: calendar.家

複製代碼

2. 全天活動的時間

全天活動的 start 是 日期（沒有時間），
而不是 datetime。處理的時候要注意。

1. {% if trigger.calendar_event.all_day %}
2.   # 全天活動，start 是 "2026-09-25"
3. {% else %}
4.   # 一般活動，start 是 "2026-09-25T18:00:00+08:00"
5. {% endif %}

複製代碼

3. 隱私

• HA 會讀取活動標題和描述
  
• 這些資料會進 recorder
  
• 不要把敏感內容放在觸發用的行事曆
  

4. 本地行事曆的替代方案

不想用 Google 的話，HA 有內建的本地行事曆：

設定 → 裝置與服務 → 新增整合 → Local Calendar

完全本地、不用授權、不用網路。
缺點是只能在 HA 裡編輯（不能用手機的行事曆 App）。

我的做法是兩個都用：
週期性的固定事項（倒垃圾、換濾網）放本地行事曆，
需要隨時在手機上改的放 Google。

---

行事曆觸發的價值在於：它是唯一能讓家裡「預知未來」的來源。

感測器只知道「現在」，行事曆知道「等一下會發生什麼」。

用得好的話，可以做出「你還沒回到家，冷氣已經先開好」
這種真的很有感的自動化。