Open source · myclub.fi · Finnish sports clubs

Manage your family's
club activities from the terminal

maiklubi is a CLI and AI agent integration for myclub.fi — check events, RSVP, view invoices and notifications across multiple members and clubs in one place.

$ npm install -g maiklubi

Stop scrolling, just ask

Summarize the discussion for next weekend's tournament
↳ Read 12 messages from the Vantaa Cup thread For the Vantaa Cup (Sat 14.6.): Johanna has a seat in Viivi's parents' car, leaving 8:15 from the hall. Also riding along: Sofia. One seat is still open with the Korhonen's. Reminder from the coach: shin guards + packed snacks — the kiosk is cash only.

Everything in one command

Stop switching between browser tabs for each child and each club. maiklubi pulls it all together.

📅

Events & RSVP

List upcoming training sessions and matches. Confirm or cancel attendance for any family member directly from the terminal.

👨‍👩‍👧‍👦

Multiple members

Configure every child across every club once. Run commands for one person or all of them with --all-members.

🧾

Invoices

See open and paid invoices at a glance — due dates, amounts, and payment references without logging in to each club separately.

🔔

Notifications

Read club announcements straight from the terminal. Never miss an important notice buried in an email digest.

📆

Calendar subscriptions

Create webcal:// subscriptions filtered by person, hobby, or attendance status — feed directly into Apple Calendar or Google Calendar.

🤖

AI agent ready

Every command supports --json output, plus a bundled agent skill. Ask your AI assistant to check who's joining tonight's practice.

Interactive mode

Just run maiklubi — a menu-driven interface guides you through browsing and acting on events, invoices, and calendars.

🔍

Date filtering

Filter events by --start and --end dates, or use --days for a rolling lookahead window.

See it in action

A quick look at the commands you'll actually use every day.

$ maiklubi events list --member Aino --start 2026-06-01 --end 2026-06-30
Events — Aino / club-a (4):
[1001] Kesätreenit ti 10.6. 15:00–16:45 Liikuntahalli
[1002] Kesätreenit ke 11.6. 16:00–17:45 Liikuntahalli
[1003] Juoksutekniikka su 15.6. 16:00–17:00 Urheilukenttä
[1004] Ottelu ti 17.6. 15:00–16:45 Liikuntahalli
$ maiklubi events indicate --member Aino --id 1003 --status yes
✓ Aino → Juoksutekniikka: osallistun
$ maiklubi invoices list --member Aino
Invoices — Aino / club-a (1):
! Kausimaksu 2026, 1. erä erääntyy 11.6.2026 85,00 €
$ maiklubi summary --all-members --days 7 --json
→ structured JSON for AI agents and scripts

Up and running in minutes

No complicated configuration. Uses your existing myclub.fi credentials.

1

Install

Run npm install -g maiklubi. Requires Node.js 18 or later.

2

Sign in

Run maiklubi — the interactive setup will ask for your myclub.fi email and password and store them securely.

3

Add family members

The tool discovers your club memberships automatically. Name each person once and you're done.

4

Start using it

Run maiklubi for the interactive menu, or use individual commands in scripts and AI workflows.

Set it up in four steps

  1. Install: npm install -g maiklubi
  2. Sign in once: run maiklubi and enter your myclub.fi email & password (stored locally).
  3. Add the skill: copy skills/maiklubi into ~/.claude/skills/ so Claude Code can use it.
  4. Just ask in plain language — Claude runs the right maiklubi … --json commands and reports back.
--json agent skill Claude Code Cursor SKILL.md
Ilmoita kaikki lapseni syksyn treeneihin — paitsi Johanna perjantain futikseen
↳ Updated 23 RSVPs across Aino, Veikko & Johanna Done — everyone's signed up for the autumn training sessions, and I left Johanna out of Friday's football as you asked. Two sessions clash with the Vantaa Cup weekend — want me to decline those too, or leave them for now?

Questions, answered

Where are my credentials stored?

On your own machine — in ~/.config/maiklubi/config.json (owner-only permissions), or via environment variables. They're only ever sent to myclub.fi to log you in; nothing goes to any third-party server.

Do I need a server or backend?

No. maiklubi is a command-line tool that runs entirely on your computer and talks directly to myclub.fi. There's nothing to host or sign up for.

Is maiklubi affiliated with myClub?

No. It's an independent, unofficial tool — not affiliated with, endorsed by, or connected to myClub / myclub.fi. You use it with your own account and credentials, at your own risk.

What can it access — is it safe?

It logs in as you and sees exactly what you'd see in the myclub.fi web app: your family's events, invoices, and notices — nothing more. Your password stays on your machine.

Will it change anything on its own?

No. Reading is read-only. It only makes changes — like RSVPing to an event — when you explicitly run that command, or ask your AI assistant to.

Can it handle several children and clubs?

Yes. Configure each family member once, across as many clubs as they belong to, then run any command for one person or for everyone at once with --all-members.

Does it work with Claude and other AI assistants?

Yes — every command has a --json mode and the repo ships an agent skill, so Claude Code and similar tools can run maiklubi for you. See the setup steps above.

Ready to simplify family club management?

Free, open source, and takes two minutes to set up.