elster-mcp-server
A Model Context Protocol (MCP) server that lets Claude (or any MCP-capable client) drive the German tax portal ELSTER via Puppeteer.
Усильте агента
Собственная команда издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]У Claude Code нет ссылки для установки локальной команды. Скопируйте команду ниже и выполните её в терминале.
ELSTER_CONFIG_PATH=<value> ELSTER_PFX_PATH=<value> ELSTER_PASSWORD=<secret> ELSTER_TAX_NUMBER=<value> ELSTER_STATE_CODE=<value> ELSTER_NAME=<value> ELSTER_FIRST_NAME=<value> ELSTER_STREET=<value> ELSTER_HOUSE_NUMBER=<value> ELSTER_ZIP=<value> ELSTER_CITY=<value> ELSTER_COUNTRY=<value> ELSTER_HEADLESS=<value> ELSTER_EST_SKIP_EUR=<value> claude mcp add io.github.lukasschwarz-elster-mcp-server -- npx -y elster-mcp-server@0.1.0Выполните в терминале.
{ "mcpServers": { "io.github.lukasschwarz-elster-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "ELSTER_CONFIG_PATH": "<value>", "ELSTER_PFX_PATH": "<value>", "ELSTER_PASSWORD": "<secret>", "ELSTER_TAX_NUMBER": "<value>", "ELSTER_STATE_CODE": "<value>", "ELSTER_NAME": "<value>", "ELSTER_FIRST_NAME": "<value>", "ELSTER_STREET": "<value>", "ELSTER_HOUSE_NUMBER": "<value>", "ELSTER_ZIP": "<value>", "ELSTER_CITY": "<value>", "ELSTER_COUNTRY": "<value>", "ELSTER_HEADLESS": "<value>", "ELSTER_EST_SKIP_EUR": "<value>" } } }}claude_desktop_config.json
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
ЗапускОт издателя
A Model Context Protocol (MCP) server that lets Claude (or any MCP-capable client) drive the German tax portal ELSTER via Puppeteer.
Drive the German tax portal ELSTER via Puppeteer: submit UStVA, prepare EUER/ESt, sync inbox.
Deutsch
Practical safeguards built into the tool
elster_ustva_confirm — it requires an explicit second call after elster_ustva_start has paused at AWAITING_CONFIRM. Nothing is sent without that second confirmation..pfx) — get it from https://www.elster.de → "Mein ELSTER" → "Mein Benutzerkonto" → "Zertifikat verlängern"git clone https://github.com/YOUR_USERNAME/elster-mcp-server.git
cd elster-mcp-server
npm install
npm run build
Puppeteer will install a bundled Chromium on first install (~150 MB).
cp config.example.json config.json
$EDITOR config.json
All keys in config.json can be overridden by environment variables
(ELSTER_PFX_PATH, ELSTER_PASSWORD, ELSTER_TAX_NUMBER,
ELSTER_STATE_CODE, ELSTER_NAME, ELSTER_FIRST_NAME, ELSTER_STREET,
ELSTER_HOUSE_NUMBER, ELSTER_ZIP, ELSTER_CITY, ELSTER_COUNTRY,
ELSTER_DOWNLOAD_DIR, ELSTER_SCREENSHOT_DIR, ELSTER_HEADLESS,
ELSTER_EST_SKIP_EUR). Env vars win over the file.
You can also point the loader at a different config file via
ELSTER_CONFIG_PATH=/path/to/your/config.json.
The two-digit stateCode for your Finanzamt is published by ELSTER —
look up the current value in the official ELSTER documentation.
Add your §13b UStG suppliers under ustva.reverseChargeSuppliers in
config.json. Patterns are case-insensitive regexes matched against the
voucher's contactName or description. Example entry:
{ "pattern": "your-supplier\\s+ireland", "region": "EU", "name": "Your Supplier Ireland" }
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"elster": {
"command": "node",
"args": ["/absolute/path/to/elster-mcp-server/dist/index.js"],
"env": {
"ELSTER_CONFIG_PATH": "/absolute/path/to/elster-mcp-server/config.json"
}
}
}
}
See examples/claude_desktop_config.json for the template.
Run the server in stdio mode:
node dist/index.js
Then connect via your client's MCP transport.
1. elster_login_test → { ok: true }
2. elster_kennziffern_list → reference for valid codes
3. elster_ustva_start({ → { sessionId: "ustva-..." }
year: 2026,
period: "Q1",
report: { "81": 12000, "86": 300, "66": 1845.30 }
})
4. elster_session_status({ sessionId }) → poll until status == AWAITING_CONFIRM
(open the screenshot at screenshotPath to verify)
5. elster_ustva_confirm({ sessionId }) → { success: true, ticket: "..." }
1. elster_login_test
2. elster_eur_start({
year: 2025,
data: {
betriebseinnahmen: 50000,
fahrzeugkosten: 1200,
afa: 800,
homeOffice: 1260
}
})
3. elster_session_status (poll until SAVED or AWAITING_REVIEW)
4. open the ELSTER portal in your browser → "Meine Formulare" → review the draft → submit manually
.env, config.json, or .pfx. They are gitignored by default.ELSTER_HEADLESS=false once to watch the first run and confirm everything is wired correctly.ELSTER_HEADLESS=false
and check the screenshots written to ./screenshots/.PRs welcome. The most useful additions are:
report schema validator for elster_ustva_*When opening an issue, please run with ELSTER_HEADLESS=false and attach the
screenshot under ./screenshots/ that shows the failure.
Drive the German tax portal ELSTER via Puppeteer: submit UStVA, prepare EUER/ESt, sync inbox.
{ "mcpServers": { "io.github.lukasschwarz-elster-mcp-server": { "command": "npx", "args": [ "-y", "[email protected]" ], "env": { "ELSTER_CONFIG_PATH": "<value>", "ELSTER_PFX_PATH": "<value>", "ELSTER_PASSWORD": "<secret>", "ELSTER_TAX_NUMBER": "<value>", "ELSTER_STATE_CODE": "<value>", "ELSTER_NAME": "<value>", "ELSTER_FIRST_NAME": "<value>", "ELSTER_STREET": "<value>", "ELSTER_HOUSE_NUMBER": "<value>", "ELSTER_ZIP": "<value>", "ELSTER_CITY": "<value>", "ELSTER_COUNTRY": "<value>", "ELSTER_HEADLESS": "<value>", "ELSTER_EST_SKIP_EUR": "<value>" } } }}Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
Издатель указывает следующие переменные окружения: ELSTER_CONFIG_PATH, ELSTER_PFX_PATH, ELSTER_PASSWORD, ELSTER_TAX_NUMBER, ELSTER_STATE_CODE, ELSTER_NAME, ELSTER_FIRST_NAME, ELSTER_STREET, ELSTER_HOUSE_NUMBER, ELSTER_ZIP, ELSTER_CITY, ELSTER_COUNTRY, ELSTER_HEADLESS, ELSTER_EST_SKIP_EUR.
Elster работает локально через stdio.
Последняя проверка: 2026-11-09. Drive the German tax portal ELSTER via Puppeteer: submit UStVA, prepare EUER/ESt, sync inbox.