Wilma access for AI agents.

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

An open-source CLI that lets AI agents read schedules, homework, exams, grades, messages, and news from Wilma. One command gives a full daily briefing.

Add Skill to Agent Install CLI

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)

Quick Start

Choose your setup and copy the commands directly into your terminal.

Use this if you want Wilma as a skill for OpenAI, Claude Code, 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

How It Works

1. Pick your tenant (city)WilmAI ships with a list of all Wilma tenants.

2. Authenticate onceYour credentials are stored locally for fast re-use.

3. Query your kidsUse JSON output or let your agent do the filtering.

What can I do with Wilma CLI?

Run the CLI interactively or let your AI agent call the right command automatically. 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

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

FAQ

Where do my credentials live?

Locally on your machine. Nothing is stored on a server.

Do I need a backend?

No. WilmAI is a CLI and skill you run on your own machine.

What if my tenant changes?

Run login again and select a different tenant.

Is this officially endorsed by Wilma or Visma?

No. This is a hobby project made by a parent who was frustrated with the Wilma app. It is not officially supported or endorsed by Visma or the Wilma service.

Is this secure?

Your credentials are stored locally on your computer. We don't store any information outside of your control. It's up to you to decide how to handle them.

What about data security and compliance?

The CLI accesses the same data as the official Wilma app or website that parents already use. It's up to you to decide how it is appropriate to use that data.