Firefly III CLI

Firefly III command-line interface based on CLI-Anything specification. Converts MCP mode to stateless CLI mode to avoid Node residual process issues.

Installation

pip install cli-anything-firefly-iii

Prerequisites

• Python 3.10+
• Running Firefly III instance
• Personal Access Token (PAT)

Configuration

Environment Variables (Recommended)

export FIREFLY_III_BASE_URL="https://firefly.yourdomain.com"
export FIREFLY_III_PAT="your-personal-access-token"

Command Line Arguments

cli-anything-firefly-iii --base-url https://firefly.yourdomain.com --pat your-token

Command Groups

Command Group	Description	Corresponding API
accounts	Account management (CRUD)	/api/v1/accounts
transactions	Transaction management (CRUD)	/api/v1/transactions
budgets	Budget management (CRUD + limits)	/api/v1/budgets
categories	Category management (CRUD)	/api/v1/categories
tags	Tag management (CRUD)	/api/v1/tags
bills	Bill management (CRUD)	/api/v1/bills
piggy-banks	Piggy bank management (CRUD + events)	/api/v1/piggy-banks
autocomplete	Autocomplete for various entities	/api/v1/autocomplete/*
currencies	Currency management (CRUD)	/api/v1/currencies
recurrences	Recurring transaction management (CRUD)	/api/v1/recurrences
rules	Rule management (CRUD + test/execute)	/api/v1/rules
rule-groups	Rule group management (CRUD + execute)	/api/v1/rule-groups
summary	Financial summaries	/api/v1/summary/*
webhooks	Webhook management (CRUD + trigger)	/api/v1/webhooks
insights	Insights and reports	/api/v1/insight/*
search	Search	/api/v1/search/*
export	Data export	/api/v1/data/export/*
info	System information	/api/v1/about

Usage Examples