# WilmAI

> WilmAI is an open-source MCP server for productivity. Read a Finnish family's Wilma school schedule, homework, exams and messages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://wilm.ai
- **Repository:** https://github.com/aikarjal/wilmai/tree/HEAD/packages/wilma-cli
- **MCP Registry name:** ai.wilm/wilma
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/wilmai
