Daily Morning Brief

Documentation Index

Fetch the complete documentation index at: https://docs.openhome.com/llms.txt

Use this file to discover all available pages before exploring further.

​

What It Does

• Gives a warm morning introduction
• Fetches local weather using Open-Meteo
• Uses the user’s OpenHome timezone for today’s date and calendar window
• Fetches today’s Google Calendar events from the primary calendar
• Counts today’s unread Gmail messages in the inbox
• Synthesizes weather, email, and calendar into a short spoken briefing
• Speaks temperatures in Celsius
• Falls back from IP-based location to saved location, then timezone-based location when possible
• Stores only non-secret location preferences for faster future weather lookup
• Exits cleanly back to the normal OpenHome conversation

​

Briefing Sections

​

Example Prompts

• “Daily brief.”
• “Morning brief.”
• “Brief me.”
• “Start my day.”
• “What’s up for today?”
• “What’s on my calendar today?”

​

Example Conversation

User: Daily brief. AI: Good morning. It’s 18 degrees and partly cloudy in Dallas, with a high of 24 and a low of 14. You have three unread emails in your inbox. On your calendar today: standup at 9, design review at 1, and gym at 6. Have a good one.

​

Trigger Phrases

• daily brief
• morning brief
• brief me
• start my day
• what's up for today
• what's on my calendar today

​

Account Linking Guide

self.capability_worker.get_token("google")

1. Open OpenHome.
2. Go to Settings -> Linked Accounts.
3. Choose Google.
4. Sign in to the Google account you want to use.
5. Approve the requested Google permissions for Gmail and Calendar access.
6. Return to OpenHome and enable or install the Daily Morning Brief ability.
7. Add trigger phrases such as daily brief, morning brief, and start my day.
8. Start a conversation and say one of the trigger phrases.

​

Data Access

​

Location Behavior

1. Public IP geolocation when available.
2. A previously saved location from daily_brief_prefs.json.
3. A timezone-based fallback for known timezones.
4. If none of those work, the weather section is reported as unavailable.

​

Stored Data

{
  "location": {
    "lat": 40.7128,
    "lon": -74.006,
    "city": "New York",
    "source": "ip_geolocation",
    "saved_at": "2026-05-14T12:00:00+00:00"
  }
}

​

Voice Flow

1. User triggers the ability.
2. The ability checks for a linked Google account.
3. It speaks a short opening line.
4. It determines the user’s timezone.
5. It resolves a weather location.
6. It fetches weather, today’s calendar events, and today’s unread Gmail count.
7. It asks the LLM to synthesize the data into three short sections: weather, email, and calendar.
8. It speaks each section with a short pause between them.
9. It speaks a short closing line.
10. It calls resume_normal_flow() so the OpenHome agent can continue normally.

​

Failure Handling

• If Google is not linked, the ability gives setup guidance and exits.
• If weather location cannot be determined, the weather section becomes unavailable instead of guessing.
• If Gmail or Calendar is temporarily unavailable, the brief continues with the data that did load.
• If every data source fails, the ability asks the user to try again later.

​

Developer Credit