Back to search
Expense-Manager-MCP-Server
MCP serverGitHub
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
Markdown
[](/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
- # Expense Manager MCP Server
- 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.
- ---
- ## Features
- - **Expense Management**:
- - `add_expense`: Log expenses with date, amount, category, subcategory, and optional notes.
- - `list_expenses`: Retrieve expense entries within an inclusive date range.
- - `get_expense`: Fetch detailed information for a specific expense by ID.
- - `update_expense`: Update existing expense records.
- - `delete_expense`: Remove an expense record by ID.
- - `search_expenses`: Full-text search across expense notes.
- - `summarize`: Generate categorized expense summaries and total spend over a date range.
- - **Resources**:
- - `expense://categories`: Read categories and subcategories dynamically from `categories.json`.
- - **Remote / HTTP Transport**: Runs as an HTTP service (default port `8000`), making it ready for remote MCP connections.
- ---
- ## Getting Started
- ### Prerequisites
- - Python 3.10+ (or Python 3.14)
- - [`uv`](https://github.com/astral-sh/uv) or `pip`
- ### Installation
- Clone the repository and install dependencies:
- ```bash
- git clone https://github.com/ashishm2909/Expense-Manager-MCP-Server.git
- cd Expense-Manager-MCP-Server
- ```
- Using `uv`:
- ```bash
- uv sync
- ```
- Or using standard `pip`:
- ```bash
- pip install fastmcp
- ```
- ---
- ## Running the Server
- Start the server directly:
- ```bash
- python main.py
- ```
- By default, the server runs an HTTP transport on `0.0.0.0:8000`.
- ---
- ## Available MCP Tools
- | Tool | Parameters | Description |
- |------|------------|-------------|
- | `add_expense` | `date`, `amount`, `category`, `subcategory`, `note` | Add a new expense record |
- | `list_expenses` | `start_date`, `end_date` | List expenses between two dates (inclusive) |
- | `get_expense` | `id` | Retrieve an expense by its ID |
- | `update_expense` | `id`, `date`, `amount`, `category`, `subcategory`, `note` | Update an existing expense record |
- | `delete_expense` | `id` | Delete an expense by ID |
- | `search_expenses` | `query` | Search expenses by matching note contents |
- | `summarize` | `start_date`, `end_date`, `category` (optional) | Summarize total spend grouped by category |
- ### Resources
- - `expense://categories`: JSON list of supported categories and their subcategories.
- ---
- ## MCP Client Configuration
- To connect this server to an MCP client (such as Claude Desktop or Antigravity):
- ### SSE / Remote HTTP Transport
- ```json
- {
- "mcpServers": {
- "expense-manager": {
- "url": "http://localhost:8000/sse"
- }
- }
- }
- ```
- ---
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.