Průvodci

Připojení

Agent umí přečíst kalendář a po tvém schválení upravit existující událost - Google Kalendář naplno, Apple Calendar s jednou výjimkou.

Co to umí a neumí

• Vypíše připojené kalendáře a jejich události.
• Upraví název, začátek nebo konec existující události.

Neumí

• Nezaloží ani nesmaže žádnou událost.
• Nehledá volné termíny mezi účastníky.
• Neobjednává nic po telefonu za tebe.

Připojení Google účtu

Google účet připojíš v portálu v sekci Připojení (v anglickém menu portálu položka „Integrations“). Jakmile je účet připojený, stejný API klíč přes REST i MCP vidí totéž - žádné druhé přihlášení navíc.

Odpojení jde jen v portálu - REST ani MCP na to endpoint nemají.

Apple Calendar

Připojuje se heslem pro konkrétní aplikaci (ne běžným heslem k Apple účtu), taky v portálu v sekci Připojení.

list_calendar_events i REST GET /v1/integrations/{id}/events podporují Apple Calendar. Vrácené neprůhledné externalId předávej beze změny jako eventId do get_calendar_event a úprav; není to iCalendar UID.

calendarId musí být jedna z adres, které vrátí list_calendars - cokoli jiného API odmítne chybou 400 calendar_invalid_calendar.

Postup pro agenta

Úprava události má vždy šest kroků, v tomto pořadí:

• 1. list_integrations - připojené kalendáře a jejich integrationId.
• 2. list_calendars - kalendáře daného připojení a jejich calendarId.
• 3. list_calendar_events, potom get_calendar_event s vráceným externalId jako eventId - načte událost a její aktuální sourceRevision.
• 4. propose_calendar_update - připraví návrh změny, zatím nic nezapisuje.
• 5. Schválení uživatelem - agent ukáže původní hodnoty a návrh, teprve pak pokračuje.
• 6. confirm_calendar_update s confirm: true - teprve tenhle krok zapíše změnu ke Google/Apple.

REST ekvivalenty: GET /v1/integrations, GET /v1/integrations/{id}/calendars, GET /v1/integrations/{id}/events, GET /v1/integrations/{id}/events/{eventId} a nakonec PATCH /v1/integrations/{id}/events/{eventId} s tělem {calendarId, sourceRevision, patch, confirm: true}.

Chyby

• calendar_stale_revision - Mezitím se událost změnila jinde - načti ji znovu (get_calendar_event) a nech uživatele schválit nový návrh.
• calendar_oauth_failed - Google odmítl přihlášení - připojení je potřeba udělat znovu v portálu.
• calendar_unauthorized - Připojení přestalo platit (odvolaný přístup, vypršelý token) - připoj účet znovu.
• calendar_confirmation_required - Zápis bez confirm: true - potvrď návrh teprve po schválení uživatelem.
• calendar_verification_failed - Zápis proběhl, ale čerstvé načtení zpět neodpovídá odeslané změně - ověř stav ručně, needituj naslepo znovu.

Úplnou tabulku se všemi kódy najdeš v sekci Google Kalendář v REST API referenci a v chybách MCP.

Zabezpečení

Přístupové tokeny k Google ani Apple účtu REST API ani MCP nikdy nevrací a ukládáme je šifrovaně. Odpojení kalendáře jde jen v portálu.