birthday-finder

Never miss a birthday again. birthday-finder hunts down your friends'
birthdays across Instagram, Facebook, Messenger, and WhatsApp, then puts
them on your Google Calendar as yearly all-day events — only ever with
your approval.

Install

Muse Code (plugins are now live — install from a marketplace or a
local bundle, all from /plugins):

git clone https://github.com/stellakaval/birthday-finder

Then in Muse Code, open /plugins and install from the local bundle
(point it at the cloned folder). Enable/disable, update, and remove all
happen from /plugins too, where you can also review the plugin's
runtime capabilities before enabling.

Don't have Muse Code yet? Install it with:

curl -fsSL dev.meta.ai/install.sh | bash

How it works

1. Tell it whose birthdays you want — your Instagram Close Friends
   (default), followers, following, or specific people.
2. It checks seven sources, all in parallel:
   • Facebook birthdays — friends who share their birthday, matched
     to your list by name.
   • Your Instagram story archive — every archived story is
     text-scanned for birthday shoutouts ("happy birthday @sam"). The
     post date becomes the birthday.
   • Your Instagram post captions — same idea, for feed posts.
   • Your Facebook posts — your timeline plus semantic search for
     birthday shoutouts.
   • Facebook stories — the live story tray (no archive API exists).
   • DMs — Messenger and Instagram DMs keyword-searched for
     birthday wishes. Message date = birthday.
   • WhatsApp — chats searched for birthday wishes.
3. You get a report grouped by confidence, each with its evidence.
   Multiple sources confirming one date = high confidence.
4. Only if you say yes, the dates go on Google Calendar as yearly,
   all-day, free-time events.

Usage

/birthdays
/birthdays --group followers
/birthdays --group following --sources facebook,ig-stories,whatsapp

Or just ask in plain language: "find my close friends' birthdays",
"whose birthday is coming up in my close friends?"

Why this exists

Instagram doesn't expose anyone's birthday through its API — not even
your close friends'. Facebook has the data but only for people who
choose to share it. So this plugin goes detective: your own birthday
posts and messages for other people are a