maiklubi skill

The maiklubi skill enables AI agents to access Finnish sports club information on myclub.fi. It retrieves upcoming events with RSVP status, open invoices, notifications, event participants, and manages calendar subscriptions for parents and athletes.

Installation

npm install -g maiklubi
# then log in once (prompts for email + password, auto-discovers members/clubs):
maiklubi login

Credentials are stored in ~/.config/maiklubi/config.json. Run maiklubi login to re-authenticate or switch account, or maiklubi config clear to remove the saved account.

Primary Commands

Daily summary (recommended starting point for agents)

maiklubi summary --member \x3Cname> --club \x3Cclub> --json
maiklubi summary --member \x3Cname> --club \x3Cclub> --days 7 --json
maiklubi summary --all-members --json

Returns upcoming events (with indication status), open invoices, and recent notifications in one call. Default lookahead: 14 days.

Events

# List upcoming events with RSVP status
maiklubi events list --member \x3Cname> --club \x3Cclub> --json
maiklubi events list --member \x3Cname> --club \x3Cclub> --with-participants --json

# RSVP (indicate attendance)
maiklubi events indicate --member \x3Cname> --club \x3Cclub> --id \x3CeventId> --status yes|no|no_response|maybe --json

# Show who is attending an event
maiklubi events participants --member \x3Cname> --club \x3Cclub> --id \x3CeventId> --json

# Read an event's discussion thread (e.g. to summarize carpooling plans)
maiklubi events comments --member \x3Cname> --club \x3Cclub> --id \x3CeventId> --json

Invoices

# Lists both open and paid invoices (open marked "!", paid marked "✓")
maiklubi invoices list --member \x3Cname> --club \x3Cclub> --json

Notifications

maiklubi notifications list --member \x3Cname> --club \x3Cclub> --limit 10 --json

Calendar subscriptions (webcal / iCalendar)

# List existing subscriptions
maiklubi calendar list --json

# Create a new subscription (returns webcal:// URL)
maiklubi calendar create --member \x3Cname> --indication yes --json

Account info

maiklubi users list --json          # configured family members
maiklubi accounts list --json       # all club memberships from myclub.fi
maiklubi version --json             # current CLI version

Key Concepts

• member: A person in your family config (e.g. "Aino", "Veikko"). Use maiklubi users list to see available names.
• club: The club slug (e.g. "topola", "ppj") or full URL. Required when a member belongs to multiple clubs.
• indication: RSVP status — yes (attending), no (not attending), no_response (not yet responded), maybe.
• --all-members: Run the command for every configured member/club pair. Produces one JSON block per pair.

Indication Symbols (text output)

• ✓ = yes (attending)
• ✗ = no (not attending)
• ? = maybe
• — = no_response (not yet answered)

Actionability Guidance

When summarizing for a parent, prioritize:

• Events with indication = "no_response" that are within 3 days — these need an RSVP
• Open invoices with a due date within 7 days
• Notifications mentioning schedule changes or mandatory actions

De-emphasize:

• Events already indicated yes or no
• Notifications that are purely informational (newsletters, results)

Notes

• All list commands support --json for structured output
• Multiple --member flags are not supported; use --all-members for all members
• The summary command is the most efficient single call for an agent briefing
• myclub.fi does not have a separate inbox; club communication is via event comments (shown by maiklubi events list) and notifications

Repository

https://github.com/jannemakela/maiklubi