← Back to directory
Personal Productivity Medium to set up Automation Monitor & Diff-Alert

Daily Birthday And Ephemeris Notification

Source reviewed Updated 2026-07-07

Daily at 7:30 AM, checks Google Contacts for birthdays or events and sends a notification via Telegram while displaying it on Home...

What it does

Get reminded of birthdays and special events every day at 7:30 AM directly in your Telegram messages and on your Home Assistant speakers. This daily check scans your Google Contacts to ensure you never miss a celebration without needing to manually review the list.

Step by step

  1. Parse the current date and format it as YYYY-MM-DD for comparison.
  2. Iterate through Google Contacts to extract fields like birthday and name.
  3. Construct a JSON payload with the notification text and target device ID.
  4. Send an HTTP POST request to the Telegram Bot API endpoint.

Where the LLM does the work

  • Generate natural language phrasing for the notification message that sounds friendly and contextual.
  • Determine if specific contacts should be excluded from notifications based on user preferences.
  • Format the output text to ensure it displays correctly on Home Assistant media players without truncation.

Watch out for

Timezone mismatches can cause missed birthdays so explicitly convert all dates to UTC before comparison.
Telegram bot tokens must be stored as secrets rather than hardcoded in the script to prevent leakage.
Home Assistant media players may ignore long messages so truncate or split text if it exceeds character limits.

Tools that fit

Google Contacts Service Retrieve personal contact details and birthday dates
Code API Logic to check for matching celebrations or ephemeris events
Telegram Service Send notification messages
Home Assistant Service Display notifications on Google Home speakers

The agent brief

Everything your agent needs, including the gotchas. Copy it and go.
agent-brief.md
You are helping me build the following AI agent workflow.

## Goal
Daily Birthday And Ephemeris Notification: Daily at 7:30 AM, checks Google Contacts for birthdays or events and sends a notification via Telegram while displaying it on Home...

## Specification
- What it does: Get reminded of birthdays and special events every day at 7:30 AM directly in your Telegram messages and on your Home Assistant speakers. This daily check scans your Google Contacts to ensure you never miss a celebration without needing to manually review the list.
- Trigger: On a schedule (Scheduled · daily 7:30 AM)
- Autonomy: Fully hands-off
- Expected setup effort: about an afternoon
- Tools/services involved:
  - Google Contacts: Retrieve personal contact details and birthday dates
  - Code: Logic to check for matching celebrations or ephemeris events
  - Telegram: Send notification messages
  - Home Assistant: Display notifications on Google Home speakers

## Known pitfalls, handle each one explicitly in your implementation
1. Timezone mismatches can cause missed birthdays so explicitly convert all dates to UTC before comparison.
2. Telegram bot tokens must be stored as secrets rather than hardcoded in the script to prevent leakage.
3. Home Assistant media players may ignore long messages so truncate or split text if it exceeds character limits.

## Reference implementation
https://n8n.io/workflows/4462 (workflow template)
Fetch and inspect this before building. If it matches my stack, adapt it;
if not, rebuild the pattern with my tools.

## Process requirements
1. Before building: ask me which of the listed tools I actually use and
   what my platform is (n8n / Make / code / other). Do not assume.
2. Adapt the pattern to my answers; do not force the reference stack.
3. Address every pitfall above; tell me how you handled each.
4. Provide a test plan I can run before letting this touch real data.
5. Ask before any step that sends messages, modifies data, or spends money.

Source: https://usecasesforagents.com/use-case/daily-birthday-and-ephemeris-notification/ via usecasesforagents.com

Frequently asked questions

Can I use a different CRM than Google Contacts?

Yes. Google Contacts is only the example CRM in this recipe. The same flow works with Agile CRM, Attio, Close CRM and Freshworks CRM. Swap the CRM connection and keep the rest of the setup as written.

Want this running in your business?

This is what I do. I design and build AI agents like this one, and keep them running. If you want it set up for your team instead of doing it yourself, get in touch.
Get in touch →

Who it's for

Built for anyone who wants this off their own plate, no team or company required.

Seen in the wild

← Back to directory