il-bank-mcp

glekner/il-bank-mcp

3.3

If you are the rightful owner of il-bank-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

IL Bank MCP is a finance assistant that integrates Israeli bank data with AI assistants, providing financial insights through a headless scraper and MCP server.

IL Bank MCP 🐷💸

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

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