myClub

Fetch accounts' sports schedules, practices, games, and events from myclub.fi. Auto-discovers accounts and clubs from your myclub.fi account. Use for checkin...

myclub Skill

Fetch sports schedules from myclub.fi, including practice times, game dates, locations, and registration status.

External Endpoints

This skill connects to the following external services:

• id.myclub.fi — Authentication (login via form POST with CSRF token)
• *.myclub.fi — Fetching club pages and event schedules (each club has its own subdomain)

No other external services are contacted.

Security & Privacy

• Credentials: Your myclub.fi email and password are stored locally in ~/.myclub-config.json with owner-only permissions (0600). They are never sent anywhere other than id.myclub.fi for authentication.
• Data flow: Login credentials are sent to id.myclub.fi over HTTPS. Schedule data is fetched from *.myclub.fi over HTTPS. No data is sent to any third party.
• No telemetry: This skill does not collect analytics, telemetry, or usage data.
• Local only: All parsed schedule data is returned to the calling agent and is not stored or transmitted elsewhere.

Trust Statement

Data that leaves your machine: your myclub.fi email and password are sent to id.myclub.fi for authentication. Schedule data is fetched from *.myclub.fi. No data is sent to any other service. Only install this skill if you trust myclub.fi with your credentials.

Setup (one-time)

python3 scripts/fetch_myclub.py setup --username [e-mail] --password your_password

Credentials are stored in ~/.myclub-config.json with owner-only permissions (600).

Commands

discover

List all available accounts and their clubs.

python3 scripts/fetch_myclub.py discover [--json]

--json: Output JSON instead of formatted text

fetch

python3 scripts/fetch_myclub.py fetch --account "Account Name" [--period PERIOD | --start DATE [--end DATE]] [--json]

--period values: this week (default), next week, this month, next month --start / --end: Custom date range in YYYY-MM-DD format (overrides --period) --json: Output JSON instead of formatted text

Event Fields

Field	Description
id	Unique event identifier
name	Event description
group	Team or group (e.g., "P2015 Black")
venue	Location
month	First day of event's month (YYYY-MM-DD)
day	Day in Finnish format (e.g., "15.3."), or null if unavailable
time	Time range (e.g., "17:00 - 18:00"), or null if unavailable
event_category	Harjoitus (training), Ottelu (game), Turnaus (tournament), Muu (other)
type	Inferred: training, game, tournament, meeting, other
registration_status	Registration status text from myclub.fi, or "unknown"

Troubleshooting

• "No .myclub-config.json found" — Run setup first
• "Unknown account 'Name'" — Run discover to check exact spelling (case-sensitive)
• Timeout / auth errors — Verify credentials with discover; check internet connection
• JSON parsing fails — myclub.fi page structure may have changed; check for data-events attribute on the calendar page

Requirements

Python 3.10+ (no external dependencies — uses only standard library).