WilmAI MCP

WilmAI connects the Wilma school system to an AI agent: schedule, homework, grades and messages in read-only mode.

  • 86 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The agent receives personal data of children from the school system: grades, absences, messages.
  • The server starts through npx from the npm registry and updates with the package.
All reasons and checks

aikarjal/wilmai

Install

Manual install

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

The first request opens a local Wilma login page. Node.js 20.18 or newer is required.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The agent receives personal data of children from the school system: grades, absences, messages.
  • The server starts through npx from the npm registry and updates with the package.

This is third-party code. Review the repository files before installing.

What it does

WilmAI connects Wilma, the Finnish school system with schedules, homework, exams, grades and messages, to the assistant or agent you already use. It ships an MCP server with 20 tools, the `wilma` command-line tool and two skills. The agent answers questions like what do the kids have at school tomorrow or is there anything I need to do this week. One call covers every child and every Wilma the family uses. The `wilma-triage` skill builds a morning briefing, flags to-dos and puts exams in the family calendar. Everything runs on your computer: there is no WilmAI server, account or telemetry, and login goes only to your school Wilma.

Who it is for. Parents and students in Finland who want a Wilma digest from their AI assistant without logging in by hand.

Good fit when

  • One morning overview is needed for the whole family: lessons, homework and tasks for today.
  • You need to know which exams are this week and what to prepare.
  • A child needs permission for a trip and the parent wants a timely reminder.
  • A daily run should show only what is new: `wilma summary --since yesterday`.

Not a fit when

  • You need to message teachers or change data: the tool only reads.
  • The school does not use Wilma.
  • You cannot keep the Wilma password on a computer: the login is stored locally in a file or keychain.

Example request

What do the kids have at school tomorrow, and is there anything this week that needs me? Build a briefing and flag the exams.

MCP

Transport
stdio
Authentication
not required

Limitations

The project is independent, made by a parent, and not affiliated with Visma or the official Wilma service. Node.js 20.18 or newer is needed for the command-line tool. The password goes into a local login page, never into a chat. The tool only reads and sends no messages, but the agent will see children data, so connect it to an assistant you trust. Meta Muse is not available in Finland yet. Two-step verification and families with several Wilmas are supported.

How to disable. Run `wilma logout` or call the logout tool and remove the MCP entry with `claude mcp remove wilma`. Then delete the saved login from the file or keychain.

FAQ

How do I connect WilmAI to Claude Code?

Run `claude mcp add --scope user wilma -- npx -y @wilm-ai/wilma-cli@2 mcp`. On first use a Wilma login page opens.

How do I connect it to Codex?

Run `codex plugin marketplace add aikarjal/wilmai`, then `codex plugin add wilma@wilmai`.

What if I want only a terminal with no MCP?

Install `npm i -g @wilm-ai/wilma-cli`, then run `wilma login` and `wilma summary`. Node.js 20.18 or newer is required.

Can the tool message a teacher?

No, it only reads: the tool sends no messages and changes nothing in Wilma.

What do the 20 tools cover?

Summary, schedule, homework, exams, grades and the gradebook, lesson notes and absences, class and teachers, messages, news with attachments, printouts and logout.

Discussion

No questions or reviews yet.

An MCP server for your personal WhatsApp account: search and read chats, contacts, send messages and files through an agent

MCP serverBroad access6.9KRepository stars

Home Memory MCP keeps a home knowledge base on your computer: rooms, devices, pipes and cables that an AI assistant manages.

MCP serverExtended access77Repository stars

A tutoring skill for STEM and AI: it finds the knowledge gap first, then teaches one step and checks understanding

SkillMinimal access267Repository stars

A bridge between World of Warcraft and local coding agents: type a task in the in-game chat and get the answer back in the game.

CLIBroad access182Repository stars
Official

A local MCP server for Mac and Windows that lets an agent work with mail, messengers, calendars and files.

MCP serverBroad access81Repository stars
Official

MWS TeamStream's official MCP: an agent finds recordings by meaning and reads transcripts and summaries right from AI tools

MCP serverExtended access

README in short

Besides the MCP there is the WilmAI Home desktop app for Mac and Windows in beta. English and Finnish guides are on wilm.ai.

README badge

Report a problem