Open Source

Event sign-ups for WhatsApp groups, without the chaos

A bot that handles RSVPs, waitlists, scheduling, team generation, and guest invites in your WhatsApp group — running on less than 100 MB of RAM.

View on GitHub Get started
< 100 MB RAM Usage
TypeScript Language
SQLite Storage
MIT License

How it works

Everything your group needs to coordinate events. Nothing it doesn't.

Slot management with automatic waitlist promotion

Admins create an event with a fixed number of slots using !create "Friday Soccer" 12. Members join with !join — once the event fills up, everyone else is added to the waitlist. When someone drops out, the first person on the waitlist is automatically promoted and notified. No manual shuffling, no missed messages.

Guest invitations

Need to bring someone who isn't in the group? Any member can add a named guest with !invite "Alex". Guests count toward the slot limit and appear in the status list tied to their inviter.

Admin-gated controls

Only group admins can create, cancel, resize, or rename events, and remove anyone by index. Members can join, leave, invite guests, and remove their own guests.

Indexed removal

Every participant and guest is numbered in the !status output. Remove anyone by number with !leave 3 — no ambiguity.

Lightweight engine

Built on Baileys (no Chromium, no Puppeteer) with SQLite via better-sqlite3. Runs comfortably on a 1 GB VPS. Ships as a single Docker image under 200 MB.

Schedule with countdown

Set a date, time, and timezone when creating an event. The !status output shows a live countdown. Reschedule anytime with !reschedule. Events auto-cancel when time is up.

Auto team generation

Shuffle all confirmed participants into balanced groups with !groups 4. Or use --close-and-group 1h to auto-close registrations and post teams an hour before the event.

Multilingual & reminders

Switch language per group with !lang es — full English and Spanish support. Enable daily reminders at 9 AM showing spots remaining and countdown.

See it in action

From creation to teams — in a single chat

⚽
Friday Soccer
You, Carlos, María, +9 others
You
!create "Friday Soccer" 10 2026-04-18 19:00 Europe/Madrid --close-and-group 1h
09:15
Count Me In
✅ Event "Friday Soccer" created!
Slots: 10
📅 Friday 18 April · 19:00
Use !join to sign up.
09:15
Carlos
!join
09:22
María
!invite "Alex"
09:30
Count Me In
📊 *Friday Soccer*
Slots: 3/10
📅 Friday 18 April · 19:00
⏱ In 4d 9h

✅ *Participants:*
1. You
2. Carlos
3. Alex (María's guest)
09:30
Count Me In
🔒 Registrations for "Friday Soccer" are now closed. Here are the groups:

Random Groups (of 5):

Group 1:
- María
- Carlos
- Lucía
- You
- Pedro

Group 2:
- Alex (María's guest)
- Andrés
- Sofía
- David
- Pablo
18:00

Try it out

Running in under 60 seconds

Terminal 
# Option 1: Docker (recommended)
mkdir .auth_info_baileys && touch events.db
docker run -it --rm \
  -v $(pwd)/.auth_info_baileys:/app/.auth_info_baileys:z \
  -v $(pwd)/events.db:/app/events.db:z \
  borlafu/whatsapp-count-me-in

# Option 2: Run locally
npm install
npm start

Next step: after running, a QR code will appear in your terminal. Scan it from WhatsApp via Settings → Linked Devices → Link a Device to connect the bot to your account.