LaunchKit · 2026
Back to Skills

Access Finland's Wilma school system from AI agents.

2
1.3k downloads
by @aikarjal

Setup & Installation

openclaw skills install @aikarjal/wilma

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install wilma

Version History

v1.4.1Mar 5, 2026 - Version note by skill developer:

Add MFA (TOTP) support for Wilma accounts with persistent secret storage

What This Skill Does

Provides AI agents access to Finland's Wilma school information system via the wilma CLI. Fetches schedules, homework, exams, grades, messages, and school news for one or more students. Run `wilma summary --json` for a full daily briefing covering today and tomorrow.

Wilma has no official API, so this CLI-based integration is the only way to pull structured school data into an AI agent workflow.

When to use it

  • Checking a child's class schedule for the day or week
  • Reviewing upcoming exams before weekend study planning
  • Reading unread teacher messages without opening the Wilma app
  • Getting a combined daily briefing across multiple children
  • Checking pending homework assignments by student name

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: What does my daughter Stella have going on at school tomorrow?

AGENT
  1. 1Run `wilma kids list --json` to confirm available student names and IDs
  2. 2Run `wilma summary --student Stella --json` to fetch tomorrow's schedule, homework, and exams in one call
  3. 3Parse the JSON output and filter for tomorrow's entries
  4. 4Return a plain-language summary of the day's events and deadlines
OUTPUT

Tomorrow Stella has Math and PE in the morning, a Finnish essay due, and a history exam on Friday.

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

Wilma account provided by your child's school or municipalityConfig file at ~/.config/wilmai/config.json, created by running `wilma` interactively at least once to store session credentialsTOTP secret if MFA is enabled on your Wilma account