Connector guide5-minute read6 MCP tools7 languages

How to Connect Datev to Cursor — via MCP

Connect DATEV to Cursor using MCP. Access accounting clients, documents, and payroll data with natural language. Step-by-step guide.

HCBy HelpCode teamUpdated 5 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

DATEV Online APIs

DATEV Online APIs

Read accounting Mandanten (clients), document types and DATEV Unternehmen online (DUO) version metadata from DATEV's official Online APIs. OAuth2 Authorization Code + PKCE bound to a real DATEV-Konto. Required by virtually every German tax consultant (Steuerberater).

tools

6

Region

DE

Category

Accounting

Authentication

OAuth 2.0

Required env vars

DATEV_CLIENT_IDDATEV_CLIENT_SECRET
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the DATEV Online APIs in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

Summary

Connect DATEV to Cursor using MCP. Access accounting clients, documents, and payroll data with natural language. Step-by-step guide.

Try asking

Example prompts for DATEV Online APIs

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

DATEV Online APIs · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

Connect DATEV to Cursor

DATEV is the accounting software most German tax consultancies (Steuerberater) work in. With AnythingMCP, Cursor can read your DATEV Mandanten and their DATEV Unternehmen online (DUO) document settings through DATEV's official Online APIs, and you ask for them in plain language instead of clicking through DATEV.

The connector is read-only today: six tools for client master data and document metadata. It does not post bookings, read payroll or upload receipts (see the FAQ below).

What you can ask Cursor

  • "List all Mandanten I have access to in DATEV." Uses datev_list_clients.
  • "Show the master data for Müller GmbH: consultant number, client number, address." Uses datev_list_clients to find the Mandant, then datev_get_client.
  • "Which of my Mandanten use DATEV Unternehmen online for documents?" Uses datev_documents_list_clients.
  • "Which document types (Belegtypen) are set up for Müller GmbH?" Uses datev_list_document_types.
  • "Which file types can Müller GmbH upload to DUO, and which DUO version are they on?" Uses datev_get_duo_version.
  • "Compare my client list with the DUO list and tell me who has no DUO access yet." Uses datev_list_clients and datev_documents_list_clients.

What you need

  • An app on the DATEV developer portal, created as a confidential client with the OpenID Connect Authorization Code Flow. Its redirect URI is https://cloud.anythingmcp.com/api/mcp-oauth/callback on AnythingMCP Cloud, or <your AnythingMCP URL>/api/mcp-oauth/callback if you self-host.
  • Subscriptions to two API products for that app: accounting:clients 2.0 and accounting:documents 2.0.
  • The app's client ID and client secret, which go into DATEV_CLIENT_ID and DATEV_CLIENT_SECRET. The portal shows the secret only once, so copy it in full.
  • A DATEV-Konto user with SmartLogin or SmartCard/mIDentity. DATEV has no machine-to-machine access for these APIs: every call runs on behalf of a real DATEV user, and Cursor sees only the Mandanten that user may see.
  • DATEV's production approval for live data. Every new DATEV app runs in the sandbox until DATEV approves it. Until then, use the DATEV Online APIs (Sandbox) connector, which is set up for DATEV's test data.

Step 1 — Create the DATEV app

Register at the DATEV developer portal, create the app as described above, subscribe it to accounting:clients 2.0 and accounting:documents 2.0, and note the client ID and secret.

Step 2 — Install the DATEV connector

On AnythingMCP Cloud, open Connectors, pick DATEV Online APIs (or the Sandbox variant) and paste the client ID and secret.

To self-host instead, start AnythingMCP with Docker and install the connector from the store at http://localhost:3000/connectors/store:

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Sign in with your DATEV-Konto

On the connector page, click Authorize with Provider and log in with your DATEV-Konto. AnythingMCP stores the refresh token encrypted and renews access tokens on its own. Confidential DATEV clients get rolling refresh tokens that last two years. Every call then carries the access token and the X-DATEV-Client-Id header that DATEV requires; you don't set either by hand.

Step 4 — Add it to Cursor

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
  2. Save the file and restart Cursor.
  3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
  4. Start chatting — the agent can now call the DATEV tools.

Available tools

ToolWhat it does
datev_list_clientsList the Mandanten your DATEV user is provisioned for (UUID, consultant number, client number, name)
datev_get_clientGet one Mandant's master data
datev_documents_list_clientsList the Mandanten with DATEV Unternehmen online document access
datev_get_documents_clientGet a Mandant's data as seen by the documents product
datev_list_document_typesList a Mandant's document types (Belegtypen)
datev_get_duo_versionGet the DUO version and the file types allowed for upload

Every per-client tool takes the Mandant's UUID as clientId. Cursor gets it from datev_list_clients; it is not the same thing as your app's DATEV_CLIENT_ID.

Troubleshooting

  • The DATEV login works, but the connection still fails. The token exchange after the login needs the exact client secret. DATEV expects it via HTTP Basic, which the connector does for you, so the usual cause is a secret that was copied incompletely or belongs to a different app. Create a new secret in the portal, paste it again and click Authorize with Provider once more.
  • Calls are refused although you are signed in. Check in the portal that the app is subscribed to both accounting:clients 2.0 and accounting:documents 2.0. The document tools need the second one.
  • The sandbox works, production does not. Your app has no production approval yet. Stay on the Sandbox connector until DATEV approves the app, then switch to DATEV Online APIs with the same credentials.
  • A Mandant is missing. datev_list_clients returns only the Mandanten your DATEV user has rights for, and datev_documents_list_clients only those with active DUO access. Check the user's rights in DATEV rather than the connector.

FAQ

Can Cursor post bookings or upload receipts to DATEV? No. The connector reads client master data and document settings only. Uploading receipts to DUO needs binary file uploads that the connector engine does not handle yet, and bookings, payroll (Lohn) and DMS are separate DATEV API products that this connector does not cover.

Is it free? AnythingMCP is open source under AGPL-3.0, so self-hosting is free, including commercial use inside your own company. AnythingMCP Cloud comes with a 7-day free trial. Access to DATEV itself is governed by your DATEV contract and the developer portal's terms.

Is my data stored by AnythingMCP? Your DATEV client secret and refresh token are stored encrypted (AES-256-GCM) in your workspace and are never shown to Cursor. When Cursor uses a tool, AnythingMCP calls DATEV and passes the result to Cursor, and the call is recorded in your workspace's audit log. AnythingMCP Cloud is hosted in Frankfurt, Germany; if the data must stay on your own infrastructure, self-host AnythingMCP.

Does Cursor support custom MCP servers on the free tier? Yes — MCP is available on Hobby, Pro and Business plans.

Next steps

Was this guide helpful?

Your DATEV Online APIs agent is one click away.

Install the connector, paste the key, prompt Cursor. Free for 7 days, no credit card.

Related guides