Remote MCP Server – Expense Tracker

A natural-language expense tracker that lets you add, update, summarize, and delete expenses by chat using Claude Desktop, powered by a remote MCP (Model Context Protocol) server.

Language: Python (100%)

---

What this project does

This repository exposes expense-tracking capabilities as MCP tools, so an AI client (like Claude Desktop) can:

• Add a new expense (amount, category, date, notes, etc.)
• Update an existing expense
• Delete an expense
• Summarize spending (by date range / category / totals)

In short: you manage expenses in plain English, the MCP server translates that into deterministic actions.

---

Why MCP?

MCP provides a standard way for AI assistants to call tools safely and consistently. This server acts as the “tool backend” for expense tracking, while Claude Desktop (or another MCP-capable client) provides the chat UI and tool-calling experience.

---

Features

• Natural-language driven expense management via Claude Desktop
• Tool-based actions (add / update / delete / summarize)
• Remote MCP server architecture (usable across machines)
• Python-only implementation (easy to extend)

---

Architecture (high level)

• Client: Claude Desktop (or any MCP client)
• Server: This repo (Remote MCP Server)
• Tools: Expense CRUD + summarization endpoints exposed via MCP
• Storage: (your implementation; document here — e.g., JSON/SQLite/Postgres)

---

Getting started

Prerequisites

• Python 3.10+ (recommended)
• Claude Desktop installed (if you want the chat-based workflow)
• (Optional) uv or pip for dependency management

Setup

1. Clone the repo

   git clone https://github.com/Puneeth0106/Remote-MCP-Server-Expense-Tracker.git
   cd Remote-MCP-Server-Expense-Tracker

2. Create and activate a virtual environment

   python -m venv .venv
   source .venv/bin/activate   # macOS/Linux
   .venv\Scripts\activate      # Windows

3. Install dependencies

   pip install -r requirements.txt

4. Start the MCP server

   Replace this command with the actual entrypoint for your repo (module/app path).

   python -m server

---

Connecting from Claude Desktop

1. Open Claude Desktop
2. Add/configure an MCP server
3. Point it to this server (host/port or command-based config depending on your setup)
4. Try prompts like:

Example prompts

• “Add an expense of 250 for groceries today.”
• “Update yesterday’s coffee expense to 120.”
• “Delete the Uber expense from last Friday.”
• “Summarize my expenses for this month by category.”
• “How much did I spend on food last week?”

---

Suggested topics (for GitHub)

mcp, mcp-server, model-context-protocol, claude, claude-desktop, expense-tracker, python, tool-calling, nlp, text-to-sql, personal-finance, automation

---

Roadmap ideas

• Add import/export (CSV)
• Add recurring expenses
• Better summaries (weekly/monthly trends)
• Add multi-user support
• Add budgets + alerts

---

Contributing

PRs are welcome. If you’re adding a feature, please include:

• A short description of the change
• Tests (if the repo has a test setup)
• Example prompts or usage notes

---

License

Add a license file if you plan to make this reusable by others (MIT is a common choice).