Connecting Google

You can connect your agent to Google Calendar— so “what’s on my schedule today?” and your morning briefing will reflect your actual calendar. This is an advanced recipe: it takes about 15 minutes to configure on Google’s side, but you only do it once.

How it works

You create a “service account” on Google (a robot with its own email address), share your calendar with it, and hand the credential to your agent through the dashboard. The agent then queries your calendar on its own — no password of yours, no access to anything else.

Step by step

1. 1
   Go to console.cloud.google.comand create a project (any name, e.g. “my-agent”).
2. 2
   In the menu, search for “Google Calendar API” and click Enable.
3. 3
   Search for “Service Accounts” → Create service account. Give it a name and finish (no role needed).
4. 4
   Open the account → Keys tab → Add key → JSON. A .json file downloads — this is the credential.
5. 5
   Copy the service account email (ends in .iam.gserviceaccount.com). In Google Calendar (web), go to your calendar settings → Share with specific people→ add that email (“See all event details” is enough; use “Make changes” if you want the agent to create events).
6. 6
   In the agent dashboard → Model & features → Environment variables: create a variable named GOOGLE_SERVICE_ACCOUNT_JSON and paste the contents of the .json file. Restart the agent.
7. 7
   In Telegram, send: “You have a Google credential in the variable GOOGLE_SERVICE_ACCOUNT_JSON. Use it to access my Google Calendar ([your email]) and tell me what I have this week. Save how to do this so you can always use it.”

The first time, the agent sets up the connection (may take a minute); after that it remembers and is instant. From here, include the calendar in any routine: “in the 7am briefing, include my appointments for the day.”

What works and what doesn’t

• Works: reading the calendar, listing events, creating and updating events (if you granted edit permission).
• Doesn’t work via this method:personal Gmail — Google only allows email access via service accounts for corporate accounts (Workspace, with domain delegation). For Gmail, wait for the platform’s official integration.