Maybe Finance Skill

Personal finance management powered by Maybe Finance - an open-source personal finance OS.

Overview

Maybe Finance is a self-hosted personal finance platform for tracking:

• Transactions - Income and expenses
• Accounts - Bank accounts, investments, loans
• Budgets - Monthly spending targets
• Net Worth - Assets minus liabilities over time
• Cash Flow - Income vs expenses analysis

Prerequisites

1. Self-hosted Maybe instance - Deploy via Docker:

   docker run -d -p 3000:3000 ghcr.io/maybe-finance/maybe:latest

2. API Token - Generate in Maybe UI: Settings → API Keys

Configuration

Set environment variables:

export MAYBE_API_URL="http://localhost:3000"
export MAYBE_API_TOKEN="your-api-token"

Usage

Account Management

# List all accounts
maybe-finance accounts list

# Add a new account
maybe-finance accounts add --name "Alipay" --type checking --balance 5000

# Update account balance
maybe-finance accounts update <account-id> --balance 6000

# Delete account
maybe-finance accounts delete <account-id>

Transaction Tracking

# List recent transactions
maybe-finance transactions list --limit 20

# Add income
maybe-finance transactions add --amount 10000 --type income --category "工資" --description "三月工資"

# Add expense
maybe-finance transactions add --amount -150 --type expense --category "餐飲" --description "午餐"

# Search transactions
maybe-finance transactions search --category "餐飲" --from 2024-01-01 --to 2024-03-31
小蔥技能站7w4.net，專業的AI技能分享平臺。

Budget Analysis

# View current month budget
maybe-finance budget current

# Analyze spending by category
maybe-finance budget analyze --month 2024-03

# Compare months
maybe-finance budget compare --from 2024-01 --to 2024-03

Net Worth & Reports

# Current net worth snapshot
maybe-finance networth

# Cash flow report
maybe-finance cashflow --period monthly

# Generate financial summary
maybe-finance summary --year 2024

Scripts

All functionality is available through scripts/maybe-cli.py:

• Handles API authentication
• Formats output for readability
• Supports JSON export for further processing

Integration Ideas

• Connect with CSV import skill for bulk transaction entry
• Schedule daily/weekly financial reports via cron
• Export data for tax preparation
• Alert on budget overruns

這個 Skill 的介面展示和文件做得不錯，但實際功能存在嚴重問題——所有資料都是寫死的示例，根本無法連線到你的真實財務賬戶。配置好了也用不了，購買前需要確認開發者是否完成了真實的 API 對接，否則只是一個"看起來很美"的空殼。功能覆蓋也不夠全面，很多說明裡的功能實際上沒有實現。總體質量：文件良好但功能殘缺，可操作性很低。