IL Bank MCP

<div align="center"> <h1>IL Bank MCP 🐷💸</h1> </div>

What is it?

IL Bank MCP is a finance assistant that brings your Israeli bank data to any AI assistant. It combines a headless scraper (powered by israeli-bank-scrapers) with an MCP server, letting LLMs analyze your transactions, track spending patterns, and provide financial insights.

✨ Demo

How to use IL Bank MCP?

Run it with Docker Compose for the quickest setup:

LEUMI_USERNAME=my_user LEUMI_PASSWORD=my_pass ... \
  docker compose up -d

Then add it to your AI assistant. For Raycast, use their MCP extension with:

docker compose -f /path/to/il-bank-mcp/docker-compose.yml run --rm -i mcp-server

<img width="886" alt="image" src="https://github.com/user-attachments/assets/27bdcdea-0c70-4f6a-8f39-2134bced7d27" />

For Claude Desktop, add to ~/.claude/config.jsonc:

{
  "mcpServers": {
    "israeli-bank-assistant": {
      "command": "docker",
      "args": [
        "compose",
        "-f",
        "/path/to/il-bank-mcp/docker-compose.yml",
        "run",
        "--rm",
        "-i",
        "mcp-server"
      ],
      "env": {
        "LEUMI_USERNAME": "your_username",
        "LEUMI_PASSWORD": "your_password"
      }
    }
  }
}

See env.example for all credential and configuration options.

Key features of IL Bank MCP

• Smart Analysis: Get spending breakdowns, detect recurring charges, and track merchant patterns
• Local & Secure: All data stays in a local SQLite database
• Multi-Provider: Works with most Israeli banks and credit cards
• Real-time Updates: Refresh data on-demand from any provider
• On-Demand Sync: Scrape your bank data whenever you need fresh insights

What questions can I ask?

Here are some questions to get insights from your financial data:

• "Analyze spending patterns of Wolt"
• "Show me all subscriptions I'm paying for and their total monthly cost"
• "Show me all transactions over ₪1,000 in the last 30 days with their categories"
• "How much did I spend on groceries last month?"
• "Compare my spending this month vs last month"

What tools does IL Bank MCP provide?

• get_transactions - Fetch transactions for any time period
• get_financial_summary - Income, expenses, and trends at a glance
• search_transactions - Find specific transactions by amount or description
• get_monthly_credit_summary - Credit card usage breakdown
• get_recurring_charges - Find subscriptions and repeated payments
• analyze_merchant_spending - Spot unusual spending patterns
• refresh_all_data - Update from all connected accounts
• get_scrape_status - Check when data was last updated

FAQ from IL Bank MCP

Which banks are supported?
Any bank supported by israeli-bank-scrapers - includes Leumi, Hapoalim, Discount, and most credit card companies.

Is my data secure?
Yes. Everything runs locally on your machine. No data leaves your computer.

Can I use it with local LLMs?
Absolutely. Works great with Ollama through Raycast for a completely offline setup.

What if scraping fails?
Check the logs in ./logs. Most issues are login-related - verify your credentials match exactly what you use on the bank's website.

Contributing

Early days - contributions welcome! 🙏

License

MIT

Acknowledgments

• israeli-bank-scrapers - Core scraping engine
• Model Context Protocol - MCP framework