Skip to content
Back to search

Expense-Manager-MCP-Server

A Model Context Protocol (MCP) server built with FastMCP for personal expense tracking and financial management. It provides tools for logging, querying, updating, and summarizing expenses stored in…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ashishm2909--expense-manager-mcp-server/badge.svg)](/listings/ashishm2909--expense-manager-mcp-server)

HTML

<a href="/listings/ashishm2909--expense-manager-mcp-server"><img src="/api/listings/ashishm2909--expense-manager-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Prerequisites

- Python 3.10+ (or Python 3.14) - [`uv`](https://github.com/astral-sh/uv) or `pip`

Installation

Clone the repository and install dependencies:

git clone https://github.com/ashishm2909/Expense-Manager-MCP-Server.git
cd Expense-Manager-MCP-Server

Using `uv`:

uv sync

Or using standard `pip`:

pip install fastmcp

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 100 lines
  1. # Expense Manager MCP Server
  2. A Model Context Protocol (MCP) server built with [FastMCP](https://github.com/jlowin/fastmcp) for personal expense tracking and financial management. It provides tools for logging, querying, updating, and summarizing expenses stored in a local SQLite database, along with pre-configured category resources.
  3. ---
  4. ## Features
  5. - **Expense Management**:
  6. - `add_expense`: Log expenses with date, amount, category, subcategory, and optional notes.
  7. - `list_expenses`: Retrieve expense entries within an inclusive date range.
  8. - `get_expense`: Fetch detailed information for a specific expense by ID.
  9. - `update_expense`: Update existing expense records.
  10. - `delete_expense`: Remove an expense record by ID.
  11. - `search_expenses`: Full-text search across expense notes.
  12. - `summarize`: Generate categorized expense summaries and total spend over a date range.
  13. - **Resources**:
  14. - `expense://categories`: Read categories and subcategories dynamically from `categories.json`.
  15. - **Remote / HTTP Transport**: Runs as an HTTP service (default port `8000`), making it ready for remote MCP connections.
  16. ---
  17. ## Getting Started
  18. ### Prerequisites
  19. - Python 3.10+ (or Python 3.14)
  20. - [`uv`](https://github.com/astral-sh/uv) or `pip`
  21. ### Installation
  22. Clone the repository and install dependencies:
  23. ```bash
  24. git clone https://github.com/ashishm2909/Expense-Manager-MCP-Server.git
  25. cd Expense-Manager-MCP-Server
  26. ```
  27. Using `uv`:
  28. ```bash
  29. uv sync
  30. ```
  31. Or using standard `pip`:
  32. ```bash
  33. pip install fastmcp
  34. ```
  35. ---
  36. ## Running the Server
  37. Start the server directly:
  38. ```bash
  39. python main.py
  40. ```
  41. By default, the server runs an HTTP transport on `0.0.0.0:8000`.
  42. ---
  43. ## Available MCP Tools
  44. | Tool | Parameters | Description |
  45. |------|------------|-------------|
  46. | `add_expense` | `date`, `amount`, `category`, `subcategory`, `note` | Add a new expense record |
  47. | `list_expenses` | `start_date`, `end_date` | List expenses between two dates (inclusive) |
  48. | `get_expense` | `id` | Retrieve an expense by its ID |
  49. | `update_expense` | `id`, `date`, `amount`, `category`, `subcategory`, `note` | Update an existing expense record |
  50. | `delete_expense` | `id` | Delete an expense by ID |
  51. | `search_expenses` | `query` | Search expenses by matching note contents |
  52. | `summarize` | `start_date`, `end_date`, `category` (optional) | Summarize total spend grouped by category |
  53. ### Resources
  54. - `expense://categories`: JSON list of supported categories and their subcategories.
  55. ---
  56. ## MCP Client Configuration
  57. To connect this server to an MCP client (such as Claude Desktop or Antigravity):
  58. ### SSE / Remote HTTP Transport
  59. ```json
  60. {
  61. "mcpServers": {
  62. "expense-manager": {
  63. "url": "http://localhost:8000/sse"
  64. }
  65. }
  66. }
  67. ```
  68. ---
  69. ## License
  70. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.