aula-mcp

Overview

aula-mcp is a TypeScript-based MCP server that bridges AI agents with Denmark's educational platform Aula. It provides secure access to school data without requiring headless browsers, using MitID authentication with locally stored credentials. The server exposes tools for accessing student profiles, weekly schedules, messages, and calendar information to AI clients like Claude, Cursor, and others via the Model Context Protocol.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• aula.discover

  Discovers user identity, children, available tools, and detected widgets

  Try:Show me what tools are availableTry:What can you access in my Aula account?
• aula.profiles.list

  Lists user profiles and associated children

  Try:Show me my children's profilesTry:List all family members in my account
• aula.presence.today

  Gets today's presence/attendance information

  Try:Who is present at school today?Try:Show me attendance for all children
• aula.calendar.events

  Retrieves calendar events

  Try:What events are on the calendar next week?Try:Show me upcoming appointments
• aula.messages.list_threads

  Lists message threads/conversations

  Try:Show me my recent messagesTry:List all conversations
• aula.messages.get_thread

  Retrieves a specific message thread

  Try:Show me the messages about the field tripTry:Get the conversation with teacher about math
• aula.notifications.list

  Lists notifications

  Try:What notifications do I have?Try:Show me recent alerts
• aula.posts.list

  Lists posts/announcements

  Try:Show me recent school announcementsTry:What posts have been published?
• aula.ugeplan.easyiq

  Gets weekly schedule (Ugeplan) for EasyIQ vendor

  Try:What's on Theo's schedule next week?Try:Show me the weekly plan
• aula.opgaver.minuddannelse

  Gets assignments (Opgaver) for MinUddannelse vendor

  Try:What assignments are due?Try:Show me homework for this week
• aula.ugebrev.minuddannelse

  Gets weekly newsletters (Ugebrev) for MinUddannelse vendor

  Try:What's in the weekly newsletter?Try:Show me the latest school bulletin
• aula.huskelisten.systematic

  Gets shopping lists (Huskeliste) for Systematic vendor

  Try:What's on the shopping list?Try:Show me required supplies

Comparable tools

Installation

git clone git@github.com/Casperjuel/aula-mcp.git
cd aula-mcp
pnpm install

# First-time MitID login (QR code in MitID app)
pnpm login

# Health check of all Aula endpoints
pnpm doctor

# Start MCP server (http://127.0.0.1:7878/mcp)
pnpm mcp

{
  "mcpServers": {
    "aula": {
      "command": "node",
      "args": ["/path/to/aula-mcp/packages/mcp-server/dist/server.js"]
    }
  }
}

Compare aula-mcp with