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
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.
Install
- Works in
Manual install
claude mcp add --scope user wilma -- npx -y @wilm-ai/wilma-cli@2 mcpThe first request opens a local Wilma login page. Node.js 20.18 or newer is required.
Access and checks
How we reviewBroad 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.
Related
MCP serversAn MCP server for your personal WhatsApp account: search and read chats, contacts, send messages and files through an agent
Home Memory MCP keeps a home knowledge base on your computer: rooms, devices, pipes and cables that an AI assistant manages.
A tutoring skill for STEM and AI: it finds the knowledge gap first, then teaches one step and checks understanding
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.
A local MCP server for Mac and Windows that lets an agent work with mail, messengers, calendars and files.
MWS TeamStream MCP server
TeamStream MCP
MWS TeamStream's official MCP: an agent finds recordings by meaning and reads transcripts and summaries right from AI tools
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.