What can you do with this server?

**My Finance MCP Server** enables Claude to act as an AI bookkeeper for personal finance tracking through natural language interactions. **Core capabilities:** * **Store financial transactions** - Upload unstructured documents (receipts, statements, CSVs) and Claude extracts structured data including date, amount, description, and category, persisting to both ChromaDB for vector search and JSON ledger for backup in `~/.my_finance_mcp/` * **Semantic search** - Query financial history using natural language (e.g., "How much did I spend on groceries last month?") to find relevant transactions across all stored data * **List transactions** - Browse stored transactions with pagination, optional category filtering, and view transaction indices * **Delete transactions** - Remove specific entries by index or wipe all data with confirmation * **Analyze spending patterns** - Ask Claude about portfolio positions, spending trends, allocations, and other financial insights from your data

My Finance MCP Server

Bare-bones Model Context Protocol server that lets Claude store personal finance transactions and later query them via semantic search. Transactions are persisted in ChromaDB for vector search plus a JSON ledger for backup.

Run it alongside Claude Desktop and you get an AI bookkeeper that remembers your receipts, statements, and portfolios—then answers natural language questions about spending trends, allocations, or anything else you upload.

Setup

Install

uv sync

Run

uv run my_finance_mcp.py

Configure Claude Desktop

Add to ~/.claude_desktop_config.json:

{ "mcpServers": { "my-finance": { "command": "uv", "args": [ "run", "--project", "/path/to/my_finance", "/path/to/my_finance/my_finance_mcp.py" ] } } }

Usage

Exposed tools:

store_transactions(transactions) – ingest structured transactions (Claude will extract them from uploaded docs)
query_financial_history(query) – run semantic search across everything stored
list_transactions(limit=20, offset=0, category=None) – page through the JSON ledger to inspect what’s saved and see each transaction’s index
delete_transactions(indices=None, delete_all=False, confirm=False) – delete entries by index or wipe them all (requires confirm=True)

Upload financial data to Claude
Say: "Store this transaction data"
Claude calls the MCP server to save it
Later ask: "How much did I spend on groceries last month?"
Claude searches your historical data via MCP
Use "Show me the stored transactions" or "Delete transaction xx" to invoke the management tools

Example Claude Desktop interaction

User: Remember these portfolio positions for later analysis. Claude: I'll help you store your portfolio positions from the uploaded CSV file for later analysis. Let me read the file and process the data.. Perfect! I've stored your portfolio positions from November 6, 2025 in your finance system. Here's a summary of what was recorded:... User: List my stored transactions Claude: Here are your current stored transactions (4 total):... User: Delete VXUS - International Stock ETF transaction Claude: The VXUS - International Stock ETF transaction has been successfully deleted from your stored transactions. User: List all transactions Claude: Here are your current stored transactions (3 total):...

Data Storage

~/.my_finance_mcp/financial_data/ - ChromaDB vector database (created automatically)
~/.my_finance_mcp/transactions.json - JSON backup of all transactions

Set the MY_FINANCE_MCP_DIR environment variable before launching Claude if you want to store data in a different directory.