How do I install the Maybe Finance skill?

Run npx skillmds@latest add lord1egypt/maybe-finance in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Maybe Finance safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Maybe Finance?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Maybe Finance free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Maybe Finance?

Lord1Egypt (@lord1egypt) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Maybe Finance by lord1egypt — Agent Skill

Name: Maybe Finance
Rating: 4.666666666666667 (3 reviews)
Author: Lord1Egypt

Maybe Finance

Personal finance management skill using Maybe Finance OS. Use when users need to track expenses, analyze budgets, monitor net worth, or manage personal finances through the Maybe Finance self-hosted platform. Supports transaction tracking, account management, budget analysis, and financial reporting.

Lord1Egypt Updated Sep 8, 2026 2 repo stars

File contents

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

Self-hosted Maybe instance - Deploy via Docker:

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

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

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

---name: maybe-financedescription: Personal finance management skill using Maybe Finance OS. Use when users need to track expenses, analyze budgets, monitor net worth, or manage personal finances through the Maybe Finance self-hosted platform. Supports transaction tracking, account management, budget analysis, and financial reporting.---# Maybe Finance SkillPersonal finance management powered by [Maybe Finance](https://github.com/maybe-finance/maybe) - an open-source personal finance OS.## OverviewMaybe 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## Prerequisites1. **Self-hosted Maybe instance** - Deploy via Docker: ```bash docker run -d -p 3000:3000 ghcr.io/maybe-finance/maybe:latest ```2. **API Token** - Generate in Maybe UI: Settings → API Keys## ConfigurationSet environment variables:```bashexport MAYBE_API_URL="http://localhost:3000"export MAYBE_API_TOKEN="your-api-token"```## Usage### Account Management```bash# List all accountsmaybe-finance accounts list# Add a new accountmaybe-finance accounts add --name "Alipay" --type checking --balance 5000# Update account balancemaybe-finance accounts update <account-id> --balance 6000# Delete accountmaybe-finance accounts delete <account-id>```### Transaction Tracking```bash# List recent transactionsmaybe-finance transactions list --limit 20# Add incomemaybe-finance transactions add --amount 10000 --type income --category "工资" --description "三月工资"# Add expensemaybe-finance transactions add --amount -150 --type expense --category "餐饮" --description "午餐"# Search transactionsmaybe-finance transactions search --category "餐饮" --from 2024-01-01 --to 2024-03-31```### Budget Analysis```bash# View current month budgetmaybe-finance budget current# Analyze spending by categorymaybe-finance budget analyze --month 2024-03# Compare monthsmaybe-finance budget compare --from 2024-01 --to 2024-03```### Net Worth & Reports```bash# Current net worth snapshotmaybe-finance networth# Cash flow reportmaybe-finance cashflow --period monthly# Generate financial summarymaybe-finance summary --year 2024```## ScriptsAll 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

Frequently asked questions