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.
Run it with Docker Compose for the quickest setup:
LEUMI_USERNAME=my_user LEUMI_PASSWORD=my_pass ... \
docker compose up -dThen 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.
- 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
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"
get_transactions- Fetch transactions for any time periodget_financial_summary- Income, expenses, and trends at a glancesearch_transactions- Find specific transactions by amount or descriptionget_monthly_credit_summary- Credit card usage breakdownget_recurring_charges- Find subscriptions and repeated paymentsanalyze_merchant_spending- Spot unusual spending patternsrefresh_all_data- Update from all connected accountsget_scrape_status- Check when data was last updated
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.
Early days - contributions welcome! 🙏
MIT
- israeli-bank-scrapers - Core scraping engine
- Model Context Protocol - MCP framework