comdirect

io.github.mad4ms/comdirect-mcp · v0.6.1

Read-only access to comdirect accounts, transactions, depots, orders and postbox documents.

Website Source code Set it up

Connect Runs on your machine

Terminal

claude mcp add comdirect-mcp -e COMDIRECT_CLIENT_ID=<COMDIRECT_CLIENT_ID> -e COMDIRECT_CLIENT_SECRET=<COMDIRECT_CLIENT_SECRET> -e COMDIRECT_USERNAME=<COMDIRECT_USERNAME> -e COMDIRECT_PASSWORD=<COMDIRECT_PASSWORD> -e COMDIRECT_MCP_PUSH_TAN_WAIT=<COMDIRECT_MCP_PUSH_TAN_WAIT> -e COMDIRECT_MCP_UNMASK_IBANS=<COMDIRECT_MCP_UNMASK_IBANS> -e COMDIRECT_MCP_MASK_NAMES=<COMDIRECT_MCP_MASK_NAMES> -e COMDIRECT_ENV_FILE=<COMDIRECT_ENV_FILE> -e COMDIRECT_MCP_CACHE_TTL=<COMDIRECT_MCP_CACHE_TTL> -e COMDIRECT_MCP_MAX_DOCUMENT_BYTES=<COMDIRECT_MCP_MAX_DOCUMENT_BYTES> -e COMDIRECT_MCP_CATEGORIES=<COMDIRECT_MCP_CATEGORIES> -e COMDIRECT_MCP_SKIP_ELICITATION=<COMDIRECT_MCP_SKIP_ELICITATION> -e COMDIRECT_MCP_LOG_FILE=<COMDIRECT_MCP_LOG_FILE> -e COMDIRECT_MCP_LOG_LEVEL=<COMDIRECT_MCP_LOG_LEVEL> -- uvx comdirect-mcp==0.6.1

claude_desktop_config.json

{
  "mcpServers": {
    "comdirect-mcp": {
      "command": "uvx",
      "args": [
        "comdirect-mcp==0.6.1"
      ],
      "env": {
        "COMDIRECT_CLIENT_ID": "<COMDIRECT_CLIENT_ID>",
        "COMDIRECT_CLIENT_SECRET": "<COMDIRECT_CLIENT_SECRET>",
        "COMDIRECT_USERNAME": "<COMDIRECT_USERNAME>",
        "COMDIRECT_PASSWORD": "<COMDIRECT_PASSWORD>",
        "COMDIRECT_MCP_PUSH_TAN_WAIT": "<COMDIRECT_MCP_PUSH_TAN_WAIT>",
        "COMDIRECT_MCP_UNMASK_IBANS": "<COMDIRECT_MCP_UNMASK_IBANS>",
        "COMDIRECT_MCP_MASK_NAMES": "<COMDIRECT_MCP_MASK_NAMES>",
        "COMDIRECT_ENV_FILE": "<COMDIRECT_ENV_FILE>",
        "COMDIRECT_MCP_CACHE_TTL": "<COMDIRECT_MCP_CACHE_TTL>",
        "COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "<COMDIRECT_MCP_MAX_DOCUMENT_BYTES>",
        "COMDIRECT_MCP_CATEGORIES": "<COMDIRECT_MCP_CATEGORIES>",
        "COMDIRECT_MCP_SKIP_ELICITATION": "<COMDIRECT_MCP_SKIP_ELICITATION>",
        "COMDIRECT_MCP_LOG_FILE": "<COMDIRECT_MCP_LOG_FILE>",
        "COMDIRECT_MCP_LOG_LEVEL": "<COMDIRECT_MCP_LOG_LEVEL>"
      }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "comdirect-mcp": {
      "command": "uvx",
      "args": [
        "comdirect-mcp==0.6.1"
      ],
      "env": {
        "COMDIRECT_CLIENT_ID": "<COMDIRECT_CLIENT_ID>",
        "COMDIRECT_CLIENT_SECRET": "<COMDIRECT_CLIENT_SECRET>",
        "COMDIRECT_USERNAME": "<COMDIRECT_USERNAME>",
        "COMDIRECT_PASSWORD": "<COMDIRECT_PASSWORD>",
        "COMDIRECT_MCP_PUSH_TAN_WAIT": "<COMDIRECT_MCP_PUSH_TAN_WAIT>",
        "COMDIRECT_MCP_UNMASK_IBANS": "<COMDIRECT_MCP_UNMASK_IBANS>",
        "COMDIRECT_MCP_MASK_NAMES": "<COMDIRECT_MCP_MASK_NAMES>",
        "COMDIRECT_ENV_FILE": "<COMDIRECT_ENV_FILE>",
        "COMDIRECT_MCP_CACHE_TTL": "<COMDIRECT_MCP_CACHE_TTL>",
        "COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "<COMDIRECT_MCP_MAX_DOCUMENT_BYTES>",
        "COMDIRECT_MCP_CATEGORIES": "<COMDIRECT_MCP_CATEGORIES>",
        "COMDIRECT_MCP_SKIP_ELICITATION": "<COMDIRECT_MCP_SKIP_ELICITATION>",
        "COMDIRECT_MCP_LOG_FILE": "<COMDIRECT_MCP_LOG_FILE>",
        "COMDIRECT_MCP_LOG_LEVEL": "<COMDIRECT_MCP_LOG_LEVEL>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "comdirect-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "comdirect-mcp==0.6.1"
      ],
      "env": {
        "COMDIRECT_CLIENT_ID": "<COMDIRECT_CLIENT_ID>",
        "COMDIRECT_CLIENT_SECRET": "<COMDIRECT_CLIENT_SECRET>",
        "COMDIRECT_USERNAME": "<COMDIRECT_USERNAME>",
        "COMDIRECT_PASSWORD": "<COMDIRECT_PASSWORD>",
        "COMDIRECT_MCP_PUSH_TAN_WAIT": "<COMDIRECT_MCP_PUSH_TAN_WAIT>",
        "COMDIRECT_MCP_UNMASK_IBANS": "<COMDIRECT_MCP_UNMASK_IBANS>",
        "COMDIRECT_MCP_MASK_NAMES": "<COMDIRECT_MCP_MASK_NAMES>",
        "COMDIRECT_ENV_FILE": "<COMDIRECT_ENV_FILE>",
        "COMDIRECT_MCP_CACHE_TTL": "<COMDIRECT_MCP_CACHE_TTL>",
        "COMDIRECT_MCP_MAX_DOCUMENT_BYTES": "<COMDIRECT_MCP_MAX_DOCUMENT_BYTES>",
        "COMDIRECT_MCP_CATEGORIES": "<COMDIRECT_MCP_CATEGORIES>",
        "COMDIRECT_MCP_SKIP_ELICITATION": "<COMDIRECT_MCP_SKIP_ELICITATION>",
        "COMDIRECT_MCP_LOG_FILE": "<COMDIRECT_MCP_LOG_FILE>",
        "COMDIRECT_MCP_LOG_LEVEL": "<COMDIRECT_MCP_LOG_LEVEL>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`COMDIRECT_CLIENT_ID` Optional, secret	comdirect API client id (or stored in the OS keychain via `comdirect-mcp configure`)
`COMDIRECT_CLIENT_SECRET` Optional, secret	comdirect API client secret (or stored in the OS keychain via `comdirect-mcp configure`)
`COMDIRECT_USERNAME` Optional, secret	comdirect Zugangsnummer (or stored in the OS keychain via `comdirect-mcp configure`)
`COMDIRECT_PASSWORD` Optional, secret	comdirect PIN (or stored in the OS keychain via `comdirect-mcp configure`)
`COMDIRECT_MCP_PUSH_TAN_WAIT` Optional	Seconds to wait for the push TAN approval if the client cannot show a confirmation dialog
`COMDIRECT_MCP_UNMASK_IBANS` Optional	Set to true to return counterparty IBANs unmasked
`COMDIRECT_MCP_MASK_NAMES` Optional	Set to true to replace counterparty names with stable pseudonyms
`COMDIRECT_ENV_FILE` Optional	Path to a dotenv file with the credentials (opt-in; prefer the OS keychain)
`COMDIRECT_MCP_CACHE_TTL` Optional	Seconds the server keeps bank results within a session; 0 disables the cache
`COMDIRECT_MCP_MAX_DOCUMENT_BYTES` Optional	Size limit for postbox documents in bytes
`COMDIRECT_MCP_CATEGORIES` Optional	Path of the category rules file (default ~/.config/comdirect-mcp/categories.toml)
`COMDIRECT_MCP_SKIP_ELICITATION` Optional	Set to 1 to skip the login confirmation dialog and wait for the push TAN approval instead
`COMDIRECT_MCP_LOG_FILE` Optional	File the server appends its log to (default stderr)
`COMDIRECT_MCP_LOG_LEVEL` Optional	Log level of the server

Details

Package	`[email protected]` (PYPI, stdio)
First published	13 Oct 2026
Last updated	13 Oct 2026
Registry name	`io.github.mad4ms/comdirect-mcp`

Live status

Local install

Installed and run on your own machine, so there is no public endpoint to check.

Pair it with live search

Agents that use comdirect often also need current facts. NestDaddy MCP gives your AI today's internet: web search, real-time breaking news and full page reading in one connector.

See NestDaddy MCP

For maintainers

[![NestDaddy MCP](https://nestdaddy.com/mcp/servers/io-github-mad4ms-comdirect-mcp/badge.svg)](https://nestdaddy.com/mcp/servers/io-github-mad4ms-comdirect-mcp)

Add the badge to your README. It turns green while your server passes our daily check. Listing details come from the official MCP registry; update them there.

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.

Connect Runs on your machine

Tools

Environment variables

Details

More files and documents servers See all