Expense Tracker MCP Server
経費トラッカー MCPサーバー
PythonとSQLite3で構築された、個人用経費トラッカーのためのローカルModel Context Protocol (MCP)サーバー。
機能
add_expense— 経費を追加します。利用可能クレジットが減りますlist_expenses— 経費を一覧表示します(新しい順)。カテゴリでの絞り込みも可能ですsummarize_expenses— カテゴリ別の合計、件数、追加されたクレジット、利用可能クレジットを集計しますedit_expense— 経費を編集します。金額の差額分クレジットが調整されますdelete_expense— 経費を削除します。金額がクレジットに返金されますadd_credit— 利用可能残高にクレジットを追加します
残高を変更するすべての操作は、SQLiteトランザクション内で実行されます。
Related MCP server: Expense Tracker MCP Server
フォルダー構造
local MCP server/
├── main.py # MCP server + tool definitions (entry point)
├── expense_tracker/
│ ├── __init__.py
│ ├── database.py # SQLite connection + schema setup
│ └── operations.py # Core expense/credit business logic
├── pyproject.toml # Project config (fastmcp dependency)
├── uv.lock # Lockfile
└── README.mdデータベースファイル expense_tracker.db は、最初のツール呼び出し時に自動的に作成されます。
インストール
リポジトリをクローンします:
git clone https://github.com/YogeshSharma2007/Local-Expense-tracker-MCP.git
cd Local-Expense-tracker-MCP仮想環境を作成して有効化します:
python -m venv .venv
.\.venv\Scripts\Activate.ps1依存関係をインストールします:
uv sync # or: pip install -e .サーバーを実行する
python main.pyその後、MCPクライアントでサーバーをローカルMCP stdioサーバーとして登録します。
MCPクライアントに登録する(OpenCodeの例)
OpenCodeの設定(opencode.jsonまたはクライアント設定が置かれている場所)に追加します:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"local-mcp": {
"type": "local",
"command": [
"<path-to-repo>\\.venv\\Scripts\\python.exe",
"<path-to-repo>\\main.py"
],
"enabled": true
}
}
}<path-to-repo> を、このリポジトリをクローンした場所のフルパスに置き換えます。例:
C:\Users\<your-username>\Documents\Local-Expense-tracker-MCP設定
データベースのパスはデフォルトでプロジェクトフォルダー内の expense_tracker.db になります。環境変数で上書きします:
$env:EXPENSE_TRACKER_DB = "C:\path\to\expense_tracker.db"This server cannot be deployed
Maintenance
Related MCP Connectors
Personal finance tracker — log transactions, view summaries, and browse a dashboard
Hosted MCP server for Mini Accountant: invoices, expenses, customers, analytics, tax estimates.
- BonsaveOAuthapp.bonsave
Query your real net worth, spending, transactions, budgets and portfolio from any MCP client.
- WalleKOAuthapp.wallek
Personal finance ledger: log expenses, track bills and cards, import statements.
Related MCP Servers
- FlicenseBqualityDmaintenanceA powerful SQLite-backed expense tracking server built with the Model Context Protocol (MCP). This server allows AI agents (like Claude) to manage your personal finances by adding, deleting, and listing expenses directly from your chat interface.3-
- FlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server for tracking personal expenses. This server provides tools to add, list, and summarize expenses, utilizing a local SQLite database for storage.3-
- FlicenseNot gradedqualityDmaintenanceA lightweight local MCP server for tracking personal or small-team expenses. It lets you add expense entries, list transactions within a date range, and generate simple summaries by category — all backed by a local SQLite database.-
- FlicenseNot gradedqualityDmaintenanceA lightweight MCP server that lets LLM clients track, query, and summarize personal expenses using a local SQLite database.-