WilmAI

Wilma, Finland's school system, with AI. Two ways to use it, both free and open source:

For your AI assistant or agent An MCP server, a CLI and agent skills. Ask Claude, ChatGPT, Codex, OpenClaw, Grok Bot or Meta Muse about school in plain words, or let your agent post one briefing for the whole family every morning.

Set up your assistant →

WilmAI Home, the desktop app A fast, modern Wilma app for students and parents: lessons, messages, homework, exams and grades in one view, a notification when something needs you, and AI if you want it. Free and open, now in beta, for Mac and Windows.

Download WilmAI Home → · More

wilm.ai (English and Finnish) · Set up · WilmAI Home, the desktop app · Changelog

You: What do the kids have at school tomorrow?

Your assistant: Kiia has crafts, geography and math, 8:30–14:00, and her English exam is on Thursday (units 7–9). Eino starts at 9:15 with swimming, so pack a swimsuit and a towel.

You: Is there anything I need to do this week?

Your assistant: Two things. Eino's trip on Friday needs your permission: return the form by Wednesday. And Kiia's art lesson on Monday is marked as an absence, so explain it in Wilma.

WilmAI connects Wilma, the system Finnish schools use for schedules, homework, exams, grades and messages, to the AI assistant or agent you already use. It's an MCP server, a command-line tool and two agent skills, free and open source. There's also WilmAI Home, a desktop app of its own for students and parents.

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

What you get

• 20 MCP tools. Summary, schedule, homework, exams, grades and the gradebook, lesson notes and absences, class and teachers, messages with replies, news with attachments, printouts, and a logout. One call covers every child, across every Wilma the family uses.
• A CLI for people and agents. Text in a terminal, JSON when a program reads it: the same JSON as the MCP tools. wilma summary --since yesterday returns only what's new, for daily runs.
• It all runs on your computer. No WilmAI server, no account, no telemetry. It logs in only to your school's Wilma and can't send messages or change anything there. The password goes into a local login page, never into a chat, and is kept in a file only you can read or, if you prefer, in your computer's keychain.
• Agent skills. wilma teaches an agent the tools and commands; wilma-triage turns them into a morning briefing that flags what needs doing and puts exams in the family calendar.
• Any school on Wilma. The login page finds your school's Wilma by city or school name. Two-step verification and families with several Wilmas work.
• Students can use it too. With their own Wilma login, a student asks about their own lessons, homework and exams.

Try it in one line

# Claude Code
claude mcp add --scope user wilma -- npx -y @wilm-ai/wilma-cli@2 mcp

# Codex
codex plugin marketplace add aikarjal/wilmai && codex plugin add wilma@wilmai

# Any MCP client
npx -y @wilm-ai/wilma-cli@2 mcp

# Just the terminal (Node.js 20.18 or newer)
npm i -g @wilm-ai/wilma-cli && wilma login && wilma summary

Then ask about school. The first time, a login page opens in your browser: pick your school's Wilma and log in. The login is saved on your computer.

Add WilmAI to your assistant

Step-by-step guides for parents, in English and Finnish: wilm.ai.

Assistant	How	Guide
Claude Desktop (Mac, Windows)	Download wilmai.mcpb and open it; Claude asks whether to install it	wilm.ai#claude
ChatGPT desktop app (Mac, Windows)	In Work mode (not Chat), send ChatGPT one message and it installs the plugin itself; or add the MCP server npx -y @wilm-ai/wilma-cli@2 mcp yourself	wilm.ai#chatgpt
Grok Bot	Send one message; the bot installs the CLI and skill itself	wilm.ai#grok
Meta Muse (not in Finland yet)	Send one message; Muse installs the CLI and skill itself, and asks you to save your Wilma login in its vault	wilm.ai#muse
OpenClaw	Send one message and OpenClaw installs the CLI and the wilma skill; a second one starts a daily briefing with wilma-triage	wilm.ai#openclaw
Claude Code	claude mcp add --scope user wilma -- npx -y @wilm-ai/wilma-cli@2 mcp	wilm.ai#claude-code
Codex	codex plugin marketplace add aikarjal/wilmai, then codex plugin add wilma@wilmai	wilm.ai#codex
Terminal	npm i -g @wilm-ai/wilma-cli, then wilma login	wilm.ai#cli

This is the beginning of the README. Read the rest at the original. Read the full README ↗