ExpenseTracker MCP Server
An MCP server for tracking personal expenses, supporting adding, listing, and summarizing expense entries with data stored in a local SQLite database.
README
ExpenseTracker MCP Server
An MCP server for tracking personal expenses, built with
FastMCP 3.x. Expenses are stored in a local SQLite database and
accessed asynchronously via aiosqlite.
Requirements
- Python >= 3.12
- uv
- Node.js (only for the MCP Inspector during development)
Setup
git clone <repo-url>
cd Test-Remote-Server
uv sync
Running
Start the server over HTTP:
uv run main.py
The server listens on http://0.0.0.0:8000/mcp. To use a different port, edit the
mcp.run(...) call at the bottom of main.py.
Development
Run the server with the MCP Inspector UI:
uv run fastmcp dev inspector main.py
If the default Inspector ports (6274/6277) are taken, pick your own:
uv run fastmcp dev inspector main.py --ui-port 6280 --server-port 6281
Note that uv run is required — the Inspector spawns fastmcp as a child process, and
without uv run the virtualenv's Scripts/bin directory is not on PATH.
Tools
| Tool | Parameters | Description |
|---|---|---|
add_expense |
date, amount, category, subcategory="", note="" |
Add a new expense entry |
list_expenses |
start_date, end_date |
List entries in an inclusive date range |
summarize |
start_date, end_date, category=None |
Total and count per category |
Dates are YYYY-MM-DD strings.
Resources
| URI | Description |
|---|---|
expense:///categories |
Category list as JSON |
Categories are read from categories.json next to main.py. If that file is absent, a
built-in default list is served instead.
Storage
The SQLite database lives at expenses.db inside the system temp directory; the path is
printed at startup. It is created automatically on first run.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.