Aula MCP Server

An MCP (Model Context Protocol) server that gives Claude real-time access to Aula.dk — the Danish school communication platform. Ask Claude about your child's school day, upcoming events, messages from teachers, and more — all translated from Danish on the fly.

Prerequisites

• Node.js 18+
• Google Chrome installed (used for MitID authentication)
• A MitID account linked to your child's Aula profile
• Claude Desktop (Windows, macOS, or Linux)

Quick Start

Add this to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "aula": {
      "command": "npx",
      "args": ["-y", "@ilenhart/aula-mcp-server"],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
        "AULA_CHILD_NAME": "YourChildFirstName"
      }
    }
  }
}

Restart Claude Desktop. Then just ask Claude: "Log me into Aula" — a Chrome window will open for MitID authentication.

How Authentication Works

Aula.dk uses Denmark's MitID national 2FA system. There's no API key — you authenticate by scanning a QR code with the MitID phone app.

1. Ask Claude to log into Aula
2. A Chrome window opens with the Aula login page
3. Click through to the MitID screen, enter your username, and scan the QR code with your MitID app
4. The server detects the completed login, captures the session cookie, and closes the browser
5. The session is kept alive automatically with background pings every 15 minutes

Sessions persist across Claude Desktop restarts (stored in ~/.aula-mcp/session.json). You only need to re-authenticate if the session expires (typically after server maintenance).

Available Tools

Authentication

Tool	Description
aula_login	Start MitID auth flow or confirm existing session
aula_check_auth	Poll for completed QR scan (called automatically)
aula_session_status	Check if current session is valid

School Data

Tool	Description
aula_get_posts	Recent school announcements and updates
aula_get_messages	Recent messages from teachers and parents
aula_get_thread	Full conversation thread by ID
aula_get_threads	All active message threads
aula_get_calendar	Calendar events with type filtering
aula_get_daily_overview	Today's attendance status and notes
aula_get_gallery	Recent photo albums and media
aula_find_people	Search for parents, teachers, and staff
aula_get_meebook	Weekly lesson plans and book lists

Configuration

All configuration is via environment variables, set in the "env" block of your Claude Desktop config.

Variable	Required	Default	Description
BROWSER_EXECUTABLE_PATH	Yes	—	Path to Chrome executable
AULA_CHILD_NAME	Yes	—	Your child's first name (for profile selection)
AULA_INSTITUTION_NAME	No	(first found)	School name (partial match)
AULA_API_URL	No	https://www.aula.dk/api/	Aula API base URL
PING_INTERVAL_MINUTES	No	15	Session keepalive interval
AULA_DATA_DIR	No	~/.aula-mcp/	Directory for session data

Common Chrome paths

• Windows: C:\Program Files\Google\Chrome\Application\chrome.exe
• macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
• Linux: /usr/bin/google-chrome

Example Conversations

You: What's happening at school this week?

Claude: Fetches posts, calendar events, and messages, translates from Danish, and gives you a summary

You: Are there any messages from the teacher I should respond to?

Claude: Checks recent message threads, identifies ones needing a reply

You: What does my child's schedule look like next week?

Claude: Pulls calendar events and MeeBook weekly plans

Development

If you want to contribute or run from source:

git clone https://github.com/ilenhart/aula-mcp-server.git
cd aula-mcp-server
npm install
npm run build

For local development with auto-reload:

npm run dev

To use the local version in Claude Desktop, update your config to point at the built file:

{
  "mcpServers": {
    "aula": {
      "command": "node",
      "args": ["C:/path/to/aula-mcp-server/dist/index.js"],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
        "AULA_CHILD_NAME": "YourChildFirstName"
      }
    }
  }
}

Troubleshooting

"No session stored" / "Session expired" Call aula_login to re-authenticate via MitID.

Chrome doesn't open Verify BROWSER_EXECUTABLE_PATH points to your actual Chrome installation. The path must be the full path to the executable, not just the directory.

"Failed to start login flow" Chrome may already be running with a conflicting profile. Try closing all Chrome windows first.

Session dies frequently The default 15-minute ping interval should keep sessions alive. If you're still losing sessions, try reducing PING_INTERVAL_MINUTES to 10.

How It Works

This server uses the @ilenhart/aula-apiclient-ts library to communicate with Aula's internal API. Authentication is handled via puppeteer-core (using your installed Chrome — no bundled browser) to capture the session cookie after MitID login.

All content from Aula is in Danish. Claude translates and interprets it conversationally when presenting it to you.

License

MIT