
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
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)
npm installBefore it works, you'll need: LEUMI_USERNAMELEUMI_PASSWORD
Getting Started
- Install dependencies:
npm install- Build the project:
npm run build- Connect to MCP Clients
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
License
MIT