Skip to content

Daily

Get birthday reminders from your contacts on Telegram

Each morning a Telegram message lists today's birthdays from your Google Contacts, with a short greeting you can send.

Runs
Daily
Apps
Google Contacts, Telegram
AI
Yes, uses the built-in AI allowance
Access
contacts.readonly; bot token

Send this to your assistant

Create a ClickRuntime automation: every day at 7:30, check my Google Contacts for birthdays today and send me a Telegram message listing them, each with a short greeting I can copy.

Paste it into your assistant. It tells you what it will send or change before it runs live.

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

Google Contacts stores birthdays, but it never tells you about them unless you also maintain a separate calendar. Clients, old colleagues and friends of friends slip by, and a message sent a day late lands very differently from one sent on the day.

Account managers, freelancers and anyone who keeps in touch with a wide network use it to make a small, personal gesture at the right moment, without keeping a second list of dates.

What you get out of it

  • You never find out a day late

    The reminder arrives in the morning, on your phone, in a chat you already check. There is time to send a note before the day gets busy.

  • A greeting ready to send

    Each name comes with a short message you can copy and adjust. It removes the pause of finding the right words, which is often why a greeting never gets sent.

  • One source of truth

    Birthdays stay in Google Contacts, where they already are. There is no calendar to keep in sync and no spreadsheet of dates to update.

  • Quiet on days with no birthdays

    No message is sent when nobody has a birthday, so the chat stays meaningful and you do not learn to ignore it.

How it works

What happens, step by step

  1. Every morning at the time you choose, ClickRuntime reads the birthdays saved in your Google Contacts.

  2. It keeps only the contacts whose birthday is today. If there are none, nothing is sent.

  3. AI writes a short, friendly greeting for each person.

  4. You get one Telegram message from your bot listing each name with its greeting.

Before it runs live

  • Connect Google Contacts
  • Connect Telegram

What you get

RunsDaily
Get birthday reminders from your contacts on Telegramtoday, 9:00Succeeded
Telegram ยท Birthday bot๐ŸŽ‚ Dana Whitfield (Northwind): Happy birthday Dana, I hope the year ahead is a great one.

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.
  • Your own rules

    Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.

  • Any number of apps

    One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.

  • AI where it helps

    Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.

  • On a schedule or on each event

    Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

  • Run it at a different time, more or less often, or only on weekdays
  • Change what the AI looks for, or how it writes the result
  • Add another app, for example also send it to Slack
  • Combine it with other Google Contacts and Telegram steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.
daily_birthday_reminders_from_google_contacts_on_telegram.pyexample
from datetime import date
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
from clickruntime import on_trigger, credentials, http, ai

CHAT_ID = 123456789  # your Telegram chat with the bot

@on_trigger
def run(event):
    people = build("people", "v1", credentials=Credentials(credentials.connection("google", "work")), cache_discovery=False)
    today, found, token = date.today(), [], None
    while True:
        page = people.people().connections().list(resourceName="people/me", pageSize=1000, pageToken=token,
                                                  personFields="names,birthdays").execute()
        for p in page.get("connections", []):
            for b in p.get("birthdays", []):
                d = b.get("date", {})
                if d.get("month") == today.month and d.get("day") == today.day and p.get("names"):
                    found.append(p["names"][0]["displayName"])
        token = page.get("nextPageToken")
        if not token:
            break
    if not found:
        return {"birthdays": 0}
    lines = [f"๐ŸŽ‚ {name}: " + ai.generate(f"Write a warm one-sentence birthday message to {name}. No emojis.",
                                          max_output_tokens=60).text.strip() for name in sorted(set(found))]
    http.post(f"https://api.telegram.org/bot{credentials.secret('TELEGRAM_BOT_TOKEN')}/sendMessage",
              json={"chat_id": CHAT_ID, "text": "Birthdays today\n\n" + "\n".join(lines)}).raise_for_status()
    return {"birthdays": len(found)}

FAQ

Common questions

Does it include contacts without a birth year?
Yes. Google Contacts lets you save a birthday with only the day and month, and those are included. When a year is saved, the greeting can mention the age, but it does not have to.
Can I get the reminder a few days early?
Yes. Ask for a reminder for birthdays coming up in the next three days, or a weekly list on Mondays, so there is time to send a card or a gift.
Can it send the greeting to the person directly?
This automation only messages you, so you choose the words and the channel. Sending a personal greeting yourself is usually what makes it land well.
What permissions does it need?
contacts.readonly; bot token. Nothing else in your accounts is used.
Does it need AI?
Yes. It uses ClickRuntime's built-in AI, so you don't need an OpenAI or Anthropic key. Every plan includes a monthly AI allowance.
How many runs does it use?
One run each time it runs (daily). Checks that find nothing to do and stop right away aren't counted.
Can I change how it works?
Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

Set up โ€œGet birthday reminders from your contacts on Telegramโ€ from your assistant

Copy the prompt above, or connect your assistant first. Free plan, no credit card.