Skip to content
MCP server

WilmAI

Read a Finnish family's Wilma school schedule, homework, exams and messages

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
2.5.0
Listing updated
3 days ago

About WilmAI

WilmAI is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Wilma access happens on your own computer: the login stays local, saved next to the config, and the assistant reads from there. An unofficial project by a parent, it says it is not affiliated with Visma or the official Wilma service.

The npm package @wilm-ai/wilma-cli runs over stdio and doubles as a command-line tool. A daily summary command returns what is new since yesterday, with schedule, exams, homework, lesson notes, messages and news across every child. Commands reuse the last Wilma session, because Wilma allows one session per account and each login would otherwise sign you out in the browser.

Errors come back as JSON with codes such as not_logged_in and login_blocked. It needs Node.js 20.18.1 or newer.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "wilma": {
      "command": "npx",
      "args": [
        "-y",
        "@wilm-ai/wilma-cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "wilma": {
      "command": "npx",
      "args": [
        "-y",
        "@wilm-ai/wilma-cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "wilma": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wilm-ai/wilma-cli"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "wilma": {
      "command": "npx",
      "args": [
        "-y",
        "@wilm-ai/wilma-cli"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "wilma": {
      "command": "npx",
      "args": [
        "-y",
        "@wilm-ai/wilma-cli"
      ]
    }
  }
}

What it does

Daily briefing
One summary for every child.
Schedule and homework
Lessons, homework and upcoming exams.
Lesson notes
Absences and teacher feedback.
Messages and news
Read school messages and attachments.
Local login
Credentials stay on your computer.
JSON errors
Structured error codes for agents.

Good for

  • Ask what the kids have this week
  • Check tomorrow's homework
  • Review upcoming exams and topics
  • Get new items since yesterday

Pricing

Open source

Free

Prices change. Check wilm.ai before you buy.

WilmAI FAQ

Is it official?

No, it is an independent open-source project not affiliated with Visma.

Is it free?

The site says it is free.

Where do my credentials go?

They stay on your computer, saved locally.

What does it need?

Node.js 20.18.1 or newer.

Is WilmAI free?

Yes. WilmAI is open source, so you can use and self-host it for free.

How do I add WilmAI to Claude Code?

Run this command in your terminal: claude mcp add wilma -- npx -y @wilm-ai/wilma-cli

What are the best alternatives to WilmAI?

The closest alternatives to WilmAI are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to WilmAI

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media