Skip to main content
MCP server CX Codex

WilmAI — Claude Code MCP server: what it does, how to install

WilmAI — an MCP server for Claude Code connects to Finland's Wilma school system. It retrieves class schedules, homework, exam dates, grades, and teacher messages directly in the agent session.

MIT ★ 89 updated 2026-11-09

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add wilma -- npx -y @wilm-ai/wilma-cli
Open on GitHub

What WilmAI does

The server exposes read-only tools to inspect timetables, homework, upcoming exams, course grades, and school announcements. Parent accounts with multiple children work automatically, with optional filters for a specific student.

Running it requires Node.js 20.18.1 or newer alongside Wilma account credentials. Wilma restricts each user to a single concurrent session, so connecting via WilmAI logs out any active browser session. Certain municipal Wilma servers reject connections originating outside Finland.

What it helps with

  • check upcoming school schedules and assigned homework
  • retrieve exam timetables and test topics
  • read unread bulletins and teacher messages
  • monitor attendance records and lesson feedback

Example prompts for the agent

  • Show my children's class schedule and homework for tomorrow
  • Check Wilma for upcoming exams and their topics next week
  • List any unread teacher messages and attendance notes

How to install WilmAI

Platform CLI

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about WilmAI

How to install WilmAI in Claude Code?

Run claude mcp add wilma -- npx -y @wilm-ai/wilma-cli.

What does WilmAI do?

It gives AI assistants read-only tools to fetch schedules, homework, report cards, and messages from the Finnish school platform Wilma.

What is required to run WilmAI?

It requires Node.js version 20.18.1 or higher and valid Wilma credentials. If two-factor authentication is active, a TOTP secret key is needed.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

From the same set3

Project sponsors

Companies that keep this analytics open