Amazon Developer Hackathon · Alexa+ track

Kharcha likho, bas bolo.

Paisa Pal is an expense tracker you control in plain language. Type what you spent, and an MCP server saves it and gives you a monthly summary.

View on GitHub Watch the demo
Example conversation
chai pe 400 kharch kiye
add_expense
Saved: 400.0 rupees for chai.
is mahine ka summary do
monthly_summary
Is mahine total 400 rupees kharch hue.
chai: 400

How it works

A simple chat UI talks to a self-hosted MCP server over Streamable HTTP.

💬

1. You type

A chat message in plain language, like a voice assistant request.

🔌

2. MCP server

A Python MCP server on /mcp picks the right tool and runs it.

📊

3. You get the answer

The expense is saved to JSON, and summaries are calculated from the same data.

MCP tools

Two tools, exposed to any MCP-compatible client.

🧾

add_expense

Takes an amount, a category and a note, then saves the expense with today's date.

📈

monthly_summary

Returns this month's total and a category-wise breakdown, highest first.

Demo video

Server, chat UI, and the saved data, in under 3 minutes.

Run it locally

The chat needs the MCP server running on your machine.

Install 
python -m venv .venv
.venv\Scripts\activate
pip install "mcp[cli]" streamlit
Start the MCP server 
python mcp_server/server.py
Start the chat UI (new terminal) 
streamlit run chat_app.py

Then open http://localhost:8501.