MCP Server

io.github.lukasschwarz/elster-mcp-server MCP Server

Name: io.github.lukasschwarz/elster-mcp-server MCP Server
Author: io.github.lukasschwarz

io.github.lukasschwarz/elster-mcp-server

Repository Registry

What is the io.github.lukasschwarz/elster-mcp-server MCP server?

Drive the German tax portal ELSTER via Puppeteer: submit UStVA, prepare EUER/ESt, sync inbox.

How to install io.github.lukasschwarz/elster-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ELSTER_CONFIG_PATH
Path to a config.json that holds all settings below. Recommended.
ELSTER_PFX_PATH
Absolute path to your ELSTER certificate (.pfx).
ELSTER_PASSWORD
secret
Password for the .pfx certificate.
ELSTER_TAX_NUMBER
Your Steuernummer in the format issued by your Finanzamt.
ELSTER_STATE_CODE
Two-digit ELSTER federal-state code of your Finanzamt.
ELSTER_NAME
Last name / company name.
ELSTER_FIRST_NAME
First name.
ELSTER_STREET
Street.
ELSTER_HOUSE_NUMBER
House number.
ELSTER_ZIP
ZIP code.
ELSTER_CITY
City.
ELSTER_COUNTRY
ISO country code, default DE.
ELSTER_HEADLESS
Run Chromium headless (true/false). Default true.
ELSTER_EST_SKIP_EUR
If 1, skip the EUER pre-hook in ESt sessions.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "elster-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "elster-mcp-server"
      ],
      "env": {
        "ELSTER_CONFIG_PATH": "<YOUR_ELSTER_CONFIG_PATH>",
        "ELSTER_PFX_PATH": "<YOUR_ELSTER_PFX_PATH>",
        "ELSTER_PASSWORD": "<YOUR_ELSTER_PASSWORD>",
        "ELSTER_TAX_NUMBER": "<YOUR_ELSTER_TAX_NUMBER>",
        "ELSTER_STATE_CODE": "<YOUR_ELSTER_STATE_CODE>",
        "ELSTER_NAME": "<YOUR_ELSTER_NAME>",
        "ELSTER_FIRST_NAME": "<YOUR_ELSTER_FIRST_NAME>",
        "ELSTER_STREET": "<YOUR_ELSTER_STREET>",
        "ELSTER_HOUSE_NUMBER": "<YOUR_ELSTER_HOUSE_NUMBER>",
        "ELSTER_ZIP": "<YOUR_ELSTER_ZIP>",
        "ELSTER_CITY": "<YOUR_ELSTER_CITY>",
        "ELSTER_COUNTRY": "<YOUR_ELSTER_COUNTRY>",
        "ELSTER_HEADLESS": "<YOUR_ELSTER_HEADLESS>",
        "ELSTER_EST_SKIP_EUR": "<YOUR_ELSTER_EST_SKIP_EUR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "elster-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "elster-mcp-server"
      ],
      "env": {
        "ELSTER_CONFIG_PATH": "<YOUR_ELSTER_CONFIG_PATH>",
        "ELSTER_PFX_PATH": "<YOUR_ELSTER_PFX_PATH>",
        "ELSTER_PASSWORD": "<YOUR_ELSTER_PASSWORD>",
        "ELSTER_TAX_NUMBER": "<YOUR_ELSTER_TAX_NUMBER>",
        "ELSTER_STATE_CODE": "<YOUR_ELSTER_STATE_CODE>",
        "ELSTER_NAME": "<YOUR_ELSTER_NAME>",
        "ELSTER_FIRST_NAME": "<YOUR_ELSTER_FIRST_NAME>",
        "ELSTER_STREET": "<YOUR_ELSTER_STREET>",
        "ELSTER_HOUSE_NUMBER": "<YOUR_ELSTER_HOUSE_NUMBER>",
        "ELSTER_ZIP": "<YOUR_ELSTER_ZIP>",
        "ELSTER_CITY": "<YOUR_ELSTER_CITY>",
        "ELSTER_COUNTRY": "<YOUR_ELSTER_COUNTRY>",
        "ELSTER_HEADLESS": "<YOUR_ELSTER_HEADLESS>",
        "ELSTER_EST_SKIP_EUR": "<YOUR_ELSTER_EST_SKIP_EUR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "elster-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "elster-mcp-server"
      ],
      "env": {
        "ELSTER_CONFIG_PATH": "<YOUR_ELSTER_CONFIG_PATH>",
        "ELSTER_PFX_PATH": "<YOUR_ELSTER_PFX_PATH>",
        "ELSTER_PASSWORD": "<YOUR_ELSTER_PASSWORD>",
        "ELSTER_TAX_NUMBER": "<YOUR_ELSTER_TAX_NUMBER>",
        "ELSTER_STATE_CODE": "<YOUR_ELSTER_STATE_CODE>",
        "ELSTER_NAME": "<YOUR_ELSTER_NAME>",
        "ELSTER_FIRST_NAME": "<YOUR_ELSTER_FIRST_NAME>",
        "ELSTER_STREET": "<YOUR_ELSTER_STREET>",
        "ELSTER_HOUSE_NUMBER": "<YOUR_ELSTER_HOUSE_NUMBER>",
        "ELSTER_ZIP": "<YOUR_ELSTER_ZIP>",
        "ELSTER_CITY": "<YOUR_ELSTER_CITY>",
        "ELSTER_COUNTRY": "<YOUR_ELSTER_COUNTRY>",
        "ELSTER_HEADLESS": "<YOUR_ELSTER_HEADLESS>",
        "ELSTER_EST_SKIP_EUR": "<YOUR_ELSTER_EST_SKIP_EUR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "elster-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "elster-mcp-server"
      ],
      "env": {
        "ELSTER_CONFIG_PATH": "<YOUR_ELSTER_CONFIG_PATH>",
        "ELSTER_PFX_PATH": "<YOUR_ELSTER_PFX_PATH>",
        "ELSTER_PASSWORD": "<YOUR_ELSTER_PASSWORD>",
        "ELSTER_TAX_NUMBER": "<YOUR_ELSTER_TAX_NUMBER>",
        "ELSTER_STATE_CODE": "<YOUR_ELSTER_STATE_CODE>",
        "ELSTER_NAME": "<YOUR_ELSTER_NAME>",
        "ELSTER_FIRST_NAME": "<YOUR_ELSTER_FIRST_NAME>",
        "ELSTER_STREET": "<YOUR_ELSTER_STREET>",
        "ELSTER_HOUSE_NUMBER": "<YOUR_ELSTER_HOUSE_NUMBER>",
        "ELSTER_ZIP": "<YOUR_ELSTER_ZIP>",
        "ELSTER_CITY": "<YOUR_ELSTER_CITY>",
        "ELSTER_COUNTRY": "<YOUR_ELSTER_COUNTRY>",
        "ELSTER_HEADLESS": "<YOUR_ELSTER_HEADLESS>",
        "ELSTER_EST_SKIP_EUR": "<YOUR_ELSTER_EST_SKIP_EUR>"
      }
    }
  }
}

Claude Code

claude mcp add elster-mcp-server --env ELSTER_CONFIG_PATH=<YOUR_ELSTER_CONFIG_PATH> --env ELSTER_PFX_PATH=<YOUR_ELSTER_PFX_PATH> --env ELSTER_PASSWORD=<YOUR_ELSTER_PASSWORD> --env ELSTER_TAX_NUMBER=<YOUR_ELSTER_TAX_NUMBER> --env ELSTER_STATE_CODE=<YOUR_ELSTER_STATE_CODE> --env ELSTER_NAME=<YOUR_ELSTER_NAME> --env ELSTER_FIRST_NAME=<YOUR_ELSTER_FIRST_NAME> --env ELSTER_STREET=<YOUR_ELSTER_STREET> --env ELSTER_HOUSE_NUMBER=<YOUR_ELSTER_HOUSE_NUMBER> --env ELSTER_ZIP=<YOUR_ELSTER_ZIP> --env ELSTER_CITY=<YOUR_ELSTER_CITY> --env ELSTER_COUNTRY=<YOUR_ELSTER_COUNTRY> --env ELSTER_HEADLESS=<YOUR_ELSTER_HEADLESS> --env ELSTER_EST_SKIP_EUR=<YOUR_ELSTER_EST_SKIP_EUR> -- npx -y elster-mcp-server