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`](https://github.com/eshaham/israeli-bank-scrapers)) with an MCP server, letting LLMs analyze your transactions, track spending patterns, and provide financial insights.

### ✨ Demo

![Raycast MCP Server running](https://raw.githubusercontent.com/glekner/il-bank-mcp/refs/heads/master/public/raycast-examples/summary.jpeg)

### How to use IL Bank MCP?

Run it with Docker Compose for the quickest setup:

```bash
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`:

```json
{
  "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](https://github.com/glekner/il-bank-mcp/blob/master/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`](https://github.com/eshaham/israeli-bank-scrapers#whats-here) - 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](https://github.com/eshaham/israeli-bank-scrapers) - Core scraping engine
- [Model Context Protocol](https://modelcontextprotocol.io/) - MCP framework