New school year? Ten-minute setup.

Wilma access for your AI agent.

This is an independent open-source project by a parent, not affiliated with, endorsed by, or connected to Visma or the official Wilma service.

Keeping up with school is work — schedules, homework, exams, messages, and news, times every kid, sometimes across different schools. WilmAI is an open-source CLI that lets your AI agent read Wilma and hand you one plain briefing for the whole family.

Add Skill to Agent Install the CLI

Downloaded thousands of times · in daily use by parents across Finland

wilma-cli

$ wilma summary --student "Kiia"

Summary for Kiia (2025-03-10)

TODAY (2025-03-10)
  08:30-09:15  Liikunta
  10:30-11:15  Matematiikka
  11:15-12:15  Suomen kieli ja kirjallisuus

TOMORROW (2025-03-11)
  08:30-09:15  Matematiikka
  09:15-10:00  Musiikki
  10:30-11:15  Englanti, A1

UPCOMING EXAMS
  2025-03-18  Englanti, A1: Unit 3 koe — Kpl 7, 8 ja 9

RECENT HOMEWORK
  2025-03-10  Englanti, A1: Opettele kpl 8 sanat
  2025-03-09  Matematiikka: s. 117 teht. 2-4

NEWS (last 7 days)
  2025-03-08  Luistelupäivä tiistaina 11.3. (id:4501)

MESSAGES (last 7 days)
  2025-03-09  Retken tiedot ja luvat (id:12345)
  2025-03-07  Uimahallikäynti pe 14.3. (id:12300)

copy, paste, done

Quick Start

Pick your setup and paste three commands into your terminal.

Adds Wilma as a skill for Claude Code, OpenAI, or OpenClaw.

# 1) Install the CLI
npm install -g @wilm-ai/wilma-cli

# 2) Login once (interactive)
wilma

# 3) Add the Wilma skill to your agent
npx skills add aikarjal/wilmai

three steps, ten minutes

How It Works

1Find your city's WilmaWilmAI knows every Wilma address in Finland. Pick yours from the list.

2Log in onceYour credentials stay in one file on your machine — never on a server.

3Ask about your kidsPlain language in, one briefing out. Your agent picks the right command.

you ask, your agent runs it

What can you ask?

Run the CLI yourself or let your agent call it. Every command works with multiple students and returns structured JSON for agents.

Daily briefing

“What do my kids have going on at school this week?”

wilma summary

Tomorrow's schedule

“What classes does Kiia have tomorrow?”

wilma schedule

Homework check

“Is there any homework due this week?”

wilma homework

Upcoming exams

“Are there any exams coming up? What should she study?”

wilma exams

Grades

“How did the last exams go?”

wilma grades

Lesson notes

“Any feedback or absences logged today?”

wilma attendance

Messages

“Any new messages from school?”

wilma messages

School news

“What's happening at school this week?”

wilma news

Multi-kid families

“Give me a summary for all my children.”

--all-students

a recipe

Pairs well with OpenClaw

Install the skill, then tell your agent what mornings should look like. Parents run things like:

“Every weekday at 7, post a school briefing for both kids to the family channel, and put new exams in the family calendar.”

One instruction — your agent handles the rest. Or skip the setup and grab the ready-made wilma-triage skill from the repo. Get the skill on ClawHub →

good questions

FAQ

Where do my credentials live?

In one file on your computer: ~/.config/wilmai/config.json, readable only by your user account. Remove it any time with wilma config clear.

Do I need a backend?

No. WilmAI runs entirely on your machine. There is no server, no account, and nothing to sign up for.

Is this secure?

WilmAI talks only to your school's official Wilma servers, using your own login. There is no middleman, no analytics, and no telemetry. It is also read-only — it can't send messages or change anything in Wilma.

Does school data end up with an AI company?

Not from the CLI — it sends data nowhere except Wilma. If you connect an agent, that agent reads the CLI's output, the same as if you pasted it into a chat. Pick a provider you trust, or stay terminal-only.

What data can it see?

Exactly what you already see as a parent in the Wilma app, fetched with your own login. Nothing extra, nothing scraped.

What if my tenant changes?

Run login again and pick the new city — you can keep several profiles side by side.

Is this officially endorsed by Wilma or Visma?

No. This is a hobby project made by a parent who wanted a better way to keep up. It is not officially supported or endorsed by Visma or the Wilma service.

why this exists

Parents keep telling me the same thing: they've never been this up to date with what's happening at school. It brings more joy than you'd expect. I hope it does the same for your family.