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 your_email@example.com --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

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).