elster-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
elster-mcp
Let Claude check and file German tax data through ELSTER, using the official ERiC library on your own machine.
Source-available, not open source. Free for individuals to run and study with credit kept intact. Business or client use, and any derivative work including one generated by an AI, needs written consent. See LICENSE. For a commercial licence or setup help, reach out through next8n.com.
What you get
Catch mistakes before ELSTER does. Tax ID, IBAN and tax-number checks run offline with the same rules ELSTER uses.
Find your tax office in seconds. List every Finanzamt per federal state and look one up by number.
Know your certificate is still good. See when your ELSTER certificate expires, without opening the ELSTER portal.
Validate a return before you send it. ERiC checks the XML locally and can write a preview PDF.
File safely. Submissions are test-only by default. A real filing needs the operator flag and your explicit approval of that exact return.
Related MCP server: elster-mcp-server
From install to first result
Download ERiC from the ELSTER developer area and extract the archive.
Register the server with Claude Code.
claude mcp add elster -s user \ -e ERIC_HOME=/path/to/ERiC-45.1.5.0/Darwin-universal \ -e ELSTER_CERT_PATH=/path/to/your-certificate.pfx \ -e ELSTER_CERT_PASSWORD_CMD="your-secret-manager command that prints the password" \ -- uv run --directory /path/to/elster-mcp elster-mcpAsk Claude to check your ELSTER setup and tell you when your certificate expires.
Tools
Tool | What it does | Contacts ELSTER |
| ERiC loads, what is configured | no |
| Validate a tax ID (IdNr) | no |
| Validate an IBAN | no |
| Validate a 13-digit ELSTER tax number | no |
| Tax number from a notice to ELSTER format | no |
| Federal-state numbers | no |
| Tax offices of one state | no |
| Details of one tax office | no |
| Test tax offices for test filings | no |
| Certificate validity, password never returned | no |
| Validate a return locally, optional preview PDF | no |
| Send a return, test mode by default | yes |
Configuration
Variable | Required | Meaning |
| yes | Extracted ERiC platform folder (contains |
| for certificate and sending | Your |
| for certificate and sending | Command that prints the password (preferred) |
| alternative | The password itself |
| to validate or send returns | Your own Hersteller-ID, the ERiC sample ID 74931 is refused |
| no |
|
| no | ERiC log folder, default |
Development
uv sync
uv run pytest # integration tests against the real ERiC library
uv run ruff check .Legal
ERiC and its Python sample wrapper are provided free of charge by the Bayerisches Landesamt für Steuern under their own licence. Neither is part of this repository. elster-mcp loads the wrapper from your own ERiC download at runtime, so you obtain ERiC, accept its licence yourself, and keep it on the current minimum version.
The ERiC documentation, schemas and sample returns are not covered by the ERiC licence for redistribution. Never commit them here;
.gitignoreand CI block them.ELSTER needs your own Hersteller-ID for every return, even an offline check. ERiC refuses the sample ID with error 610301202.
Keep your own backups of every return you prepare or send.
Only file returns for the certificate holder. Preparing returns for other people is reserved for tax advisors (StBerG).
ELSTER is a registered trademark of the Freistaat Bayern. This project is not affiliated with or endorsed by the tax administration. See docs/TRADEMARKS.md.
Privacy notice from the tax administration
The ERiC licence requires that end users see this notice before using software built on ERiC:
Datenschutzhinweis durch die Finanzverwaltung: "Mit dieser Software werden personenbezogene Daten im Sinne des Art. 4 Nr. 1 Datenschutzgrundverordnung (DSGVO) und Art. 9 Abs. 1 DSGVO zum Zwecke der Verarbeitung erhoben. Neben den reinen Daten, die zur Steuerveranlagung benötigt werden, erhebt die Software Daten über die Art des Betriebssystems des Nutzers und übermittelt diese an die Finanzverwaltung. Diese Daten werden benötigt, um die ordnungsgemäße Verarbeitung der Daten sicherzustellen und Fehlern im Verarbeitungsprozess vorzubeugen. Die Nutzung der Daten erfolgt im Rahmen des Art. 6 Abs. 1 UAbs. 1 Buchst. e i.V.m. Abs. 3 UAbs. 1 Buchst. b DSGVO i.V.m. bundes- bzw. landesgesetzlicher Steuergesetze durch die Finanzverwaltung und nur für den genannten Zweck."
The tax administration's full GDPR information letter (Articles 12 to 14) ships as Annex 2 of lizenz.pdf in your ERiC download. Read it before your first submission.
License
Source-available under the ELSTER-MCP Source-Available License. Not open source and not MIT. Built by Mirza Iqbal. Questions, configuration help, or a commercial licence through next8n.com.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Create, send and track invoices from a conversation in Claude, ChatGPT or any MCP client that supports OAuth. Draft an invoice from one sentence or from last month's invoice for the same client, finalize it, email it to your client and send payment reminders for overdue ones. See revenue by month and by client, download PDFs and e-invoices (ZUGFeRD, XRechnung), and export DATEV packages for your tax advisor. Invoices follow the tax rules of 25 countries, including reverse charge and the small-business VAT exemption. New invoices are drafts, and nothing is emailed until you ask. Pay per invoice with no subscription: the first invoice is free.
Connect Claude to Dutch accounting software: e-Boekhouden invoices, contacts and ledgers.
XRechnung and ZUGFeRD e-invoicing (EN 16931): create, validate, check Leitweg-IDs, German VAT.
Ask Claude about your income and spending, and import bank statements. No bank login.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to locally parse, validate, audit, explain, generate, and convert XRechnung and ZUGFeRD/Factur-X e-invoices using official rule sets, fully offline with no API keys required.Apache 2.0
- AlicenseBqualityBmaintenanceEnables MCP clients to drive the German ELSTER tax portal by filling forms by Kennzahl, running checks, and reviewing exactly what would be sent, with final submission left to the user. It also supports read-only access to submissions, history, and inbox data plus draft and session management.3248 npm2MIT
- AlicenseAqualityCmaintenanceGives Claude direct, keyless access to Polish public registries: it validates NIP checksums, checks a company's VAT status and bank account against the VAT whitelist, pulls KRS court-registry extracts, and fetches the correct NBP exchange rate for an invoice date. Runs locally as an MCP server for Claude Desktop, Claude Code, Cursor and other MCP clients.51MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to read, validate against the official KoSIT rules (no Java), create, and display XRechnung and ZUGFeRD e-invoices, and export incoming invoices as DATEV posting batches. Running it with a cloud language model sends invoice contents to that provider's service.MIT