Skip to main content
Glama
StefanStadler

DATEV-MCP-Server

by StefanStadler
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

DATEV-MCP-Server

MCP-Server vor einer bestehenden DATEV-REST-API (Sandbox).

Status (22.10.2026): Sandbox-Anbindung läuft. Tools: list_clients, list_document_types, upload_document, reconcile_statement, HR-Beispiel (hr_check_client, hr_create_employee, hr_add_absence, hr_delete_absence, hr_get_job, Spec hr_exchange 1.0.29 aus dem DATEV Developer Portal). Demos siehe demo/README.md.

Schnellstart

Voraussetzung: Node.js 22 (siehe .nvmrc) und eine App in der DATEV-Sandbox mit Client-ID, Client-Secret und Redirect-URI http://localhost. Die Scopes accounting:clients:read, accounting:documents und für die HR-Tools datev:hr:payrolldataexchange müssen abonniert sein.

npm install
cp .env.example .env     # DATEV_CLIENT_ID und DATEV_CLIENT_SECRET eintragen
npm run login            # Browser-Login (PKCE), speichert die Tokens in .tokens.json
npm run inspect          # Tools im MCP Inspector ausprobieren

.env und .tokens.json enthalten Zugangsdaten und sind per .gitignore ausgeschlossen. Nie committen.

Einbindung in Claude Code (stdio):

npm run build
claude mcp add datev -- node --env-file=$PWD/.env $PWD/dist/index.js

Danach lässt sich der Server direkt fragen, etwa „Welche Tools hat der DATEV-MCP?“. Beispielabläufe stehen in demo/README.md.

Related MCP server: sevdesk-mcp

Sandbox (Online APIs)

Authorization

https://login.datev.de/openidsandbox/authorize

Token

https://sandbox-api.datev.de/token

API-Basis

https://accounting-documents.api.datev.de/platform-sandbox/v2 (enthält /clients, /clients/{id}/document-types, /clients/{id}/documents)

Scopes

accounting:clients:read, accounting:documents, datev:hr:payrolldataexchange

Header

Authorization: Bearer … und X-DATEV-Client-Id (OAuth-Client-ID)

Ablauf

Authorization Code Flow mit PKCE

  • DATEV stellt in der Sandbox ein eigenes Benutzerkonto bereit, SmartLogin ist nicht nötig.

  • Für den Produktivzugang prüft DATEV technisch. Vorher braucht es eine Beraternummer und einen Onboarding-Termin.

MCP-Design

  • Wenige, gut beschriebene Tools, getrennt nach lesend und schreibend.

  • Das DATEV-Token bleibt im Server und gelangt nie zum Modell.

  • Schreibende Tools laufen nur mit Bestätigung.

  • Der MCP-Server bekommt eine eigene Absicherung, getrennt von der DATEV-Authentifizierung.

Quellen

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • SnelStart MCP Server

    mralbertzwolle
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables seamless integration with SnelStart accounting data, allowing users to manage multiple administrations, process invoices, and handle bookings through the B2B API. It supports comprehensive read/write operations, VAT summary generation, and document processing for UBL invoices and bank statements.
    -

  • sevdesk-mcp

    Honeyfield-Org
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables interaction with the sevDesk accounting API for managing contacts, invoices, credit notes, orders, vouchers, transactions, and parts.
    9 npm
    1
    MIT

  • Lexware Office MCP Server

    bdiaby1
    A
    license
    A
    quality
    B
    maintenance
    Enables MCP-capable assistants to query and manage Lexware Office contacts, sales documents, vouchers, files, payments, webhooks, and reference data via the Lexware Office public API. Adds bank reconciliation tools for matching bank statement CSVs against Lexware vouchers or scanned receipt PDFs.
    4
    MIT