MoonCal
  • Tools
  • Guides
  • Festivals
MoonCal

Lunar birthday calendar for Apple, Google, Outlook & Fastmail

Explore

  • Tools
  • Guides
  • How it works
  • Festivals

Legal

  • Privacy
  • Terms
© 2026 MoonCal
MoonCal —Chinese Lunar Birthday Calendar - Chinese lunar birthdays, on the right day every year | Product HuntPowered by Startup Fast

Send us feedback

Bug, idea, or question — tell us what you think. We read every message.

MoonCal guides

How to add a lunar birthday to iPhone Calendar

Updated · 2026-05-27

iPhone Calendar can show the Chinese calendar — turn on Settings → Calendar → Alternate Calendars → Chinese and a small lunar date appears under each day. But that's display only: it can't make an event repeat on the lunar calendar. Save a lunar birthday as a normal yearly repeat and it fires on the Gregorian date, drifting 10–11 days off every year.

The reliable fix is to subscribe to an ICS feed that pre-computes the correct Gregorian date of the lunar birthday for the next 20 years. This guide does that with MoonCal in about five minutes — on iPhone first, and the same subscription syncs to Apple Calendar on your Mac and iPad.

Can iPhone Calendar repeat lunar birthdays?

Short answer: not on its own. The Chinese alternate calendar setting only adds a lunar label next to each day for reference — it doesn't change how events recur. iOS has no "repeat yearly by lunar date" option, so the only way to get a birthday that lands on the right Gregorian day every year is an external calendar that computes those dates and that your iPhone subscribes to.

Step 1 — Create a MoonCal calendar

  1. Sign up at usemooncal.com (free, no credit card).
  2. Click "Create calendar" and give it a name — "Family birthdays" or whatever makes sense.
  3. Pick a calendar language: English event titles or 中文. You can change this later.
  4. Skip the festival presets for now — we'll add a birthday next.

Step 2 — Add the lunar birthday

  1. On the calendar page, click "Add event".
  2. Title: e.g. "Mom's birthday".
  3. Event type: Birthday.
  4. Date type: Lunar.
  5. Enter the lunar month and day. If the birthday is in a leap month, tick "This is a leap month" and pick a fallback strategy for years without that leap month — usually "Use the same regular month".
  6. Optional but useful: enter the birth year. MoonCal will then show "(N)" in the event title — for example "Mom's birthday (66)" — and recompute each year.
  7. Pick reminders. We default to 1 day and 3 days before; you can disable either.
  8. Save.
If you're not sure whether the lunar birthday was a leap month or not, ask the family member directly. Most older Chinese family records use the lunar calendar, and only a few years between 1900 and 2100 actually have a leap month — leaving the leap-month checkbox off is the right answer for >90% of cases.

Step 3 — Subscribe on iPhone

  1. In MoonCal, open your calendar's detail page and tap "Copy" next to the subscription URL (it starts with https://).
  2. On iPhone, open Settings → Calendar → Accounts → Add Account → Other.
  3. Tap "Add Subscribed Calendar".
  4. Paste the MoonCal subscription URL, tap Next, then Save.
  5. Open the subscription again under Settings → Calendar → Accounts to confirm "Use SSL" is on and to adjust how often it refreshes.
Subscribing on iPhone keeps the calendar on that device. If you'd rather set it up once for all your Apple devices, add it on a Mac under iCloud instead (see below) — it then appears on iPhone and iPad automatically.

Make sure alerts are enabled

Every event MoonCal generates carries a 1-day and 3-day reminder (VALARM). For these to actually fire on your iPhone, leave alerts enabled when you add the subscription, and check that Settings → Notifications → Calendar is allowed to send notifications.

If you filled in the birth year, MoonCal recomputes the age each year and embeds it in the event title (for example "Mom's birthday (66)"). iPhone Calendar shows that title verbatim, so the reminder banner already says which year you're celebrating.

Also works on Mac and iPad

The same subscription works across Apple Calendar on every device. The simplest way to cover all of them at once is to subscribe on a Mac and store it in iCloud:

  1. Open Apple Calendar on your Mac.
  2. Menu bar → File → New Calendar Subscription… (or press ⌥⌘S).
  3. Paste the MoonCal subscription URL and click Subscribe.
  4. Choose iCloud as the location so it syncs to your iPhone and iPad, set "Auto-refresh" to "Every hour", and tick "Alerts" if you want reminders on this device.
  5. Click OK — the next 20 years of dates appear immediately.
Storing the subscription in iCloud is what makes it show up on every device automatically. The trade-off: iCloud's own sync slows refresh to roughly daily, which is fine for birthdays that are fixed 20 years out. If you want faster refresh on a Mac specifically, store it under "On My Mac" instead.

Common gotchas

  • Lunar birthday saved as a Gregorian yearly repeat — it drifts 10–11 days every year. Delete it and re-add it as a Lunar date in MoonCal.
  • Relying on the Chinese alternate calendar setting alone — it only labels days, it doesn't make birthdays recur. You still need the subscription.
  • Calendar notifications turned off in iOS Settings → Notifications → Calendar — reminders silently never fire.
  • Refresh set to a long interval (or "Manually") — edits and new events take a while to show. Set it to hourly where you can.
  • Subscription stored in iCloud but iCloud Calendar disabled on a device — Settings → [your name] → iCloud → turn on Calendar.

Add your first lunar birthday to iPhone

Sign up free, add one lunar birthday, and subscribe to the URL on your iPhone. The whole flow takes about five minutes and stays correct for 20 years — on iPhone, Mac, and iPad.

Get started — free

Related guides

Chinese lunar birthday reminder for your family

Parents and grandparents often celebrate by the Chinese lunar calendar, and those birthdays are easy to forget because they move every year. Here's how to set up a reminder in the calendar app you already use — once, for good.

Read guide

What is a lunar leap month, and why most calendar apps get it wrong

Lunar leap months appear about seven times every nineteen years and break naive birthday-repeat logic. Here is what they are, why your calendar app probably ignores them, and the three strategies MoonCal uses to handle them correctly.

Read guide

How to add a Chinese lunar birthday to Google Calendar

Google Calendar repeats events on the Gregorian calendar, so a lunar birthday set as a yearly repeat drifts wrong every year. Here's how to add one correctly with an ICS subscription that updates automatically — step-by-step for desktop and mobile.

Read guide

How often does Google Calendar refresh ICS subscriptions?

Google Calendar pulls ICS subscription feeds roughly every 8–24 hours and there is no manual refresh button. Here are the real refresh intervals for every major calendar app, plus how to fix subscriptions that look empty or out of date.

Read guide