Skip to content
TakoAPI
Back to skills

firefly-iii

by pushp1997

Calendar & Scheduling
886Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Manage personal finances via Firefly III API.

Description

What This Skill Does

Provides API access to a self-hosted Firefly III personal finance instance. Covers creating and listing transactions, managing accounts and balances, setting budget limits, tracking savings goals via piggy banks, and automating categorization with rules.

All financial data stays on your own server, so transaction history is not shared with any third-party cloud service.

When to Use It

  • Log a grocery purchase to a category after shopping
  • Check how much of a monthly food budget has been spent
  • Set up a recurring rent payment for automatic tracking
  • Create a vacation savings goal with a target date and amount
  • Search past transactions by description to find a specific charge

Example Workflow

INPUT

User asks: Log a $50 grocery purchase from my checking account and show my food budget progress

AGENT
  1. 1

    Create a withdrawal transaction for $50.00 from 'Checking Account' to 'Supermarket' with category 'Groceries'

  2. 2

    Retrieve the list of budgets to locate the 'Food' budget ID

  3. 3

    Fetch the current spent and limit amounts for that budget period

  4. 4

    Return the transaction confirmation and budget progress

OUTPUT

Transaction logged (ID: 142). Food budget: $230.00 spent of $500.00 limit this month.

Requirements

  • FIREFLY_URL environment variable set to your Firefly III instance URL
  • FIREFLY_TOKEN Personal Access Token generated from Firefly III profile OAuth settings
  • Self-hosted Firefly III installation

Installation

clawhub install pushp1997/firefly-iii

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links