Israeli Bank MCP

A project for managing Israeli bank accounts and transactions using the Model Context Protocol (MCP).

Features

• List available Israeli banks and credit card companies with their required credentials

• Fetch transactions from any supported bank

• Support for all major Israeli banks and credit card companies

• Secure credential handling

• Flexible transaction date ranges

• Two-factor authentication support

Related MCP server: Lunch Money MCP Server

Getting Started

1. Install dependencies:

npm install

2. Build the project:

npm run build

3. Connect to MCP Clients

Connecting to MCP Clients

The server can be connected to any MCP-compatible client. Here's how to configure it:

Example Configuration

Credentials are read from environment variables (never from tool arguments — this avoids leaking them into the LLM conversation history). Each bank requires <BANK_ID>_<FIELD> env vars. For example, Bank Leumi needs LEUMI_USERNAME and LEUMI_PASSWORD; Hapoalim needs HAPOALIM_USERCODE and HAPOALIM_PASSWORD. Use the banks://list resource to see required env-var names per bank.

For clients that support configuration files (like Claude), add the following to your configuration:

{
    "mcpServers": {
        "israeli-bank-mcp": {
            "command": "node",
            "args": [
                "/path/to/israeli-bank-mcp/build/server.js"
            ],
            "env": {
                "LEUMI_USERNAME": "your-username",
                "LEUMI_PASSWORD": "your-password"
            }
        }
    }
}

Resources

• Banks (banks://list)

  • List available banks and their required credentials

Tools

• Fetch transactions (fetch-transactions)

  • Fetch transactions from a bank

• 2FA (two-factor-auth)

  • 2FA authentication for banks that require that

Supported Banks

The server supports all major Israeli banks and credit card companies through the israeli-bank-scrapers library:

• Bank Hapoalim

• Leumi Bank

• Discount Bank

• Mercantile Bank

• Mizrahi Bank

• Otsar Hahayal Bank

• Visa Cal

• Max (Formerly Leumi Card)

• Isracard

• Amex

• Union Bank

• Beinleumi

• Massad

• Yahav

• Beyhad Bishvilha

• OneZero (Experimental)

• Behatsdaa

Security

• Please do not attempt this at home (I honestly don't know, it's probably not a good idea, but it's really cool)

License

MIT