skills.rest
HKUDS
HKUDSOFFICIAL
Explore all skills by this author →
WebsiteGitHub

cli-anything-firefly-iii

Manages Firefly III personal finance data through a stateless command-line interface.

48.8k|4.5k|Updated Mar 8, 2026
Search Tags:#CLI#expense tracking#personal finance#Automation#budget management#REST api#firefly iii
One-click install
npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-firefly-iii
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cli-anything-firefly-iii
Source: https://github.com/HKUDS/CLI-Anything/tree/main/firefly-iii/agent-harness/cli_anything/firefly_iii/skills
Command: npx skills add https://github.com/HKUDS/CLI-Anything --skill cli-anything-firefly-iii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing personal finances in Firefly III through its web UI or raw REST API calls is slow and hard to automate. This Skill exposes the full Firefly III API as a stateless CLI with JSON output, letting AI agents and scripts manage accounts, transactions, budgets, and reports without maintaining long-running MCP processes.

Core Features & Use Cases

  • Full API Coverage: CRUD operations for accounts, transactions, budgets, categories, tags, bills, piggy banks, currencies, recurring transactions, rules, webhooks, and more.
  • Reporting & Insights: Generate expense/income reports, budget summaries, and export financial data for any date range.
  • Preset Filtering: Restrict available commands with presets like budget, reporting, or automation to control scope.
  • Use Case: Ask an agent to record a $15.50 lunch expense, then generate a monthly category-grouped expense report and export the transactions as JSON for further analysis.

Quick Start

Set the FIREFLY_III_BASE_URL and FIREFLY_III_PAT environment variables, then ask the agent to check the connection with info status and list your asset accounts.

Frequently Asked Questions about cli-anything-firefly-iii

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Firefly III transactions from the command line?▼

Use the transactions command group with list, get, create, update, and delete subcommands. Add the --json flag for structured output, and filter by date range with --start and --end parameters.

How do I authenticate the Firefly III CLI with my instance?▼

Set the FIREFLY_III_BASE_URL and FIREFLY_III_PAT environment variables, or pass --base-url and --pat as command-line arguments. Generate the Personal Access Token in Firefly III under Options, Profile, OAuth.

What is the difference between the CLI-Anything version and the MCP version of Firefly III?▼

The CLI version is stateless: each command runs once and exits, releasing memory immediately. The MCP version is a long-running stateful process using stdio or SSE. Both support preset filtering, but the CLI covers the full Firefly III API.

Why does the Firefly III CLI return an authentication failed error?▼

Authentication fails when the Personal Access Token is invalid or expired. Verify the FIREFLY_III_PAT value, generate a new token in Firefly III under Options, Profile, OAuth, and confirm the base URL is reachable.

Can I restrict which Firefly III commands are available?▼

Yes, use the --preset parameter with values like default, basic, budget, reporting, admin, automation, or full. Each preset exposes only the command groups relevant to that scenario, reducing the available command surface.

Related Skills

Explore More Finance & Accounting Skills→
chiyonnchiyonn

firefly-transaction

Register Firefly III transactions using a Nomad-retrieved API token via curl.

Community
Advanced
aneymaneym

plaid

Fetch balances, transactions, and spending insights from connected Plaid accounts.

Community
Advanced
AeyeOpsAeyeOps

transaction-processing

Automate C-corporation financial transaction processing with bank feed setup and OCR receipt capture.

Official
Advanced
overviewlabsoverviewlabs

mcporter

Manage MCP servers from the terminal with list, auth, config, and call commands.

Community
Intermediate