Eltern-Portal MCP Server

An MCP server that provides access to German school Eltern-Portal data. Enables AI assistants to fetch substitution plans, parent letters, bulletin board announcements, and school calendar events.

Tools

Prerequisites

• Python 3.10+
• An Eltern-Portal parent account
• An Anthropic API key (for vertretungsplan HTML parsing)

Installation

cd plugins/elternportal
pip install -r elternportal_mcp/requirements.txt

Configuration

The server loads credentials in this priority order:

1. Config file (recommended)

Create ~/.mcp-server-config/elternportal_mcp/.env:

URL=https://yourschool.eltern-portal.org
USER=your@email.com
PASSWORD=your-password
ANTHROPIC_API_KEY=sk-ant-...

This is the simplest setup. The server reads this file on startup and uses the values as defaults. No other configuration needed.

2. Environment variables (override)

Environment variables take precedence over the config file. Both long and short names are supported:

3. Plugin .mcp.json (auto-configured via marketplace)

When installed as a Cowork plugin, the .mcp.json is auto-discovered. It uses ${VAR} syntax to pull from the environment. Set the env vars via ~/.claude/settings.json:

{
  "env": {
    "ELTERNPORTAL_URL": "https://yourschool.eltern-portal.org",
    "ELTERNPORTAL_USER": "your@email.com",
    "ELTERNPORTAL_PASSWORD": "your-password",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

Manual MCP client config

For non-plugin setups, add to your .mcp.json:

{
  "elternportal": {
    "command": "python",
    "args": ["-m", "elternportal_mcp"],
    "cwd": "/path/to/plugins/elternportal",
    "env": {
      "ELTERNPORTAL_URL": "https://yourschool.eltern-portal.org",
      "ELTERNPORTAL_USER": "your@email.com",
      "ELTERNPORTAL_PASSWORD": "your-password",
      "ANTHROPIC_API_KEY": "sk-ant-..."
    }
  }
}

License

MIT