your-money-left-the-chat

Your Money Left The Chat is a Rust-native, SQLite-backed, LLM-powered financial tracking MCP server. It runs locally and stores all data offline, letting you log expenses through natural language conversations. You can interact with Claude or Ollama through the MCP CLI to input spending, and the system will categorize, summarize, and analyze your spending trends over daily, monthly, and yearly horizons. The agent can also estimate taxes and present insights via smart summaries and a visual graph view (available via Claude). To use it, start the executable that backs the MCP server and point your MCP agent to the local database file you configured during setup. The system is designed to be offline-first and private, with data kept on your machine.

Prerequisites:

• Rust toolchain (rustup, cargo)
• SQLite library and runtime
• GNU Make
• Diesel CLI (for SQLite)

Step-by-step installation:

1. Install prerequisites

   • Rust: https://www.rust-lang.org/tools/install
   • SQLite: https://sqlite.org/download.html
   • GNU Make: https://www.gnu.org/software/make/

2. Clone the repository and change into it

   • git clone https://github.com/Rayato159/your-money-left-the-chat cd your-money-left-the-chat

3. Install Diesel CLI (SQLite feature set)

   • cargo install diesel_cli --no-default-features --features sqlite
   • If you encounter a sqlite3 library error, ensure sqlite3 is installed on your system

4. Prepare the SQLite database

   • Create a file named database.db in a suitable folder or use a path you specify later

5. Database setup (migrations)

   • make migrate-up
   • or via cargo: diesel migrate run

6. Build the project

   • make build-release
   • or via cargo: cargo build --release --bin your_money_left_the_chat

7. Configure the MCP config

   • In config.json, add the money server pointing to the built binary and database path, for example: Windows: { "mcpServers": { "money": { "command": "PATH-TO\your-money-left-the-chat\target\release\your_money_left_the_chat.exe", "args": ["PATH-TO/database.db"] } } } Linux/macOS: { "mcpServers": { "money": { "command": "PATH-TO/your-money-left-the-chat/target/release/your_money_left_the_chat", "args": ["PATH-TO/database.db"] } } }

8. Run and chat with your MCP agent

   • Start the MCP agent and point it to the config file. Then you can chat: You: "Hey, I spent 129 baht on KFC today" MCP Agent: "Got it! I've logged that expense for you. Anything else?"

Tips and known considerations:

• The system stores data locally in SQLite; ensure you back up database.db regularly if you need backups.
• If you modify the database path, update the config.json accordingly.
• For CLI interactions, Claude or Ollama is used through the MCP CLI agent; ensure those models are available/installed on your machine.
• If you see migration errors, verify that Diesel's SQLite feature is correctly installed and that the database file is accessible with proper permissions.
• This is an offline-first solution; there is no cloud syncing by default.
• If the build fails due to environment issues, confirm that your environment has the required dev tools (Rust, Make, SQLite headers) installed for your OS.