What can you do with the Firefly III integration?

LiveContext exposes 239 operations on Firefly III, covering bill, budget, exchange rate and transaction.

Firefly III integration

Firefly III is a self-hosted personal finance manager. This integration covers its v1 API: read and write asset, expense, revenue and liability accounts, transactions and their splits, budgets and budget limits, categories, tags, bills, subscriptions, piggy banks, recurring transactions and rules with their rule groups, currencies and exchange rates, attachments, object groups and links between transactions, run a rule or a rule group over existing transactions, search transactions and accounts, read the insight and chart series behind the dashboard, autocomplete any of those objects for pickers, manage webhooks and their messages and attempts, and read or update user preferences and configuration. The host is part of the credential because every Firefly III install is its own deployment. Authentication is a Personal Access Token created under Options, Profile, OAuth, sent as a bearer token.

239 toolsTokenAPI docs

Connect Firefly III How integrations work

What you can do with Firefly III

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Bill, 6 operations

GETautocomplete_bills
Returns all bills of the user returned in a basic auto-complete array.
POSTcreate_bill
Store a new bill.
DELETEdelete_bill
Delete a bill.
GETexport_bills
Export bills from Firefly III.
GETget_bill
Get a single bill.
GETinsight_expense_bill
Insight into expenses, grouped by bill.

Budget, 6 operations

GETautocomplete_budgets
Returns all budgets of the user returned in a basic auto-complete array.
POSTcreate_budget
Store a new budget.
DELETEdelete_budget
Delete a budget.
GETexport_budgets
Export budgets and budget amount data from Firefly III.
GETget_budget
Get a single budget.
GETinsight_expense_budget
Insight into expenses, grouped by budget.

Exchange rate, 6 operations

POSTcreate_exchange_rate
Store a new currency exchange rate.
DELETEdelete_exchange_rate
Delete a specific currency exchange rate.
DELETEdelete_exchange_rate_for_date
Delete the currency exchange rate from 'from' to 'to' on the specified date.
DELETEdelete_exchange_rates_for_currency_pair
Deletes ALL currency exchange rates from 'from' to 'to'.
GETget_exchange_rate
List a single specific exchange rate.
GETget_exchange_rate_for_date
List the exchange rate for the from and to-currency on the requested date.

Transaction, 6 operations

GETautocomplete_transactions
Returns all transaction descriptions of the user returned in a basic auto-complete array.
POSTbulk_update_transactions
Bulk update transaction properties. For more information, see https://docs.firefly-iii.org/references/firefly-iii/api/specials/.
POSTcreate_transaction
Store a new transaction.
DELETEdelete_transaction
Delete a transaction.
GETexport_transactions
Export transaction data from Firefly III.
GETget_transaction
Get a single transaction.

Account, 5 operations

GETautocomplete_accounts
Returns all accounts of the user returned in a basic auto-complete array.
POSTcreate_account
Create new account.
DELETEdelete_account
Permanently delete account.
GETexport_accounts
Export account data from Firefly III.
GETget_account
Get single account.

Categorie, 5 operations

GETautocomplete_categories
Returns all categories of the user returned in a basic auto-complete array.
POSTcreate_category
Store a new category.
DELETEdelete_category
Delete a category.
GETexport_categories
Export category data from Firefly III.
GETget_category
Get a single category.

Piggy bank, 5 operations

GETautocomplete_piggy_banks
Returns all piggy banks of the user returned in a basic auto-complete array.
POSTcreate_piggy_bank
Store a new piggy bank.
DELETEdelete_piggy_bank
Delete a piggy bank.
GETexport_piggy_banks
Export piggy banks from Firefly III.
GETget_piggy_bank
Get a single piggy bank.

Rule, 5 operations

GETautocomplete_rules
Returns all rules of the user returned in a basic auto-complete array.
POSTcreate_rule
Store a new rule.
DELETEdelete_rule
Delete an rule.
GETexport_rules
Export rule groups and rule data from Firefly III.
GETget_rule
Get a single rule.

Subscription, 5 operations

GETautocomplete_subscriptions
Returns all subscriptions of the user returned in a basic auto-complete array.
POSTcreate_subscription
Store a new subscription.
DELETEdelete_subscription
Delete a subscription.
GETexport_subscriptions
Export subscriptions from Firefly III.
GETget_subscription
Get a single subscription.

Tag, 5 operations

GETautocomplete_tags
Returns all tags of the user returned in a basic auto-complete array.
POSTcreate_tag
Store a new tag.
DELETEdelete_tag
Delete an tag.
GETexport_tags
Export tag data from Firefly III.
GETget_tag
Get a single tag.

Currencie, 4 operations

GETautocomplete_currencies
Returns all currencies of the user returned in a basic auto-complete array.
POSTcreate_currency
Store a new currency.
DELETEdelete_currency
Delete a currency.
GETget_currency
Get a single currency.

Rule group, 4 operations

GETautocomplete_rule_groups
Returns all rule groups of the user returned in a basic auto-complete array.
POSTcreate_rule_group
Store a new rule group.
DELETEdelete_rule_group
Delete a rule group.
GETget_rule_group
Get a single rule group.

User, 4 operations

POSTcreate_user
Store a new user.
DELETEdelete_user
Delete a user.
GETget_authenticated_user
Currently authenticated user endpoint.
GETget_user
Get a single user.

Attachment, 3 operations

POSTcreate_attachment
Store a new attachment.
DELETEdelete_attachment
Delete an attachment.
GETget_attachment
Get a single attachment.

Limit, 3 operations

POSTcreate_budget_limit
Store new budget limit.
DELETEdelete_budget_limit
Delete a budget limit.
GETget_budget_limit
Get single budget limit.

Link type, 3 operations

POSTcreate_link_type
Create a new link type.
DELETEdelete_link_type
Permanently delete link type.
GETget_link_type
Get single a link type.

Object group, 3 operations

GETautocomplete_object_groups
Returns all object groups of the user returned in a basic auto-complete array.
DELETEdelete_object_group
Delete a object group.
GETget_object_group
Get a single object group.

Overview, 3 operations

GETget_account_chart
Dashboard chart with asset account balance information.
GETget_budget_chart
Dashboard chart with budget information.
GETget_category_chart
Dashboard chart with category information.

Recurrence, 3 operations

POSTcreate_recurrence
Store a new recurring transaction.
DELETEdelete_recurrence
Delete a recurring transaction.
GETget_recurrence
Get a single recurring transaction.

Transaction link, 3 operations

POSTcreate_transaction_link
Create a new link between transactions.
DELETEdelete_transaction_link
Permanently delete link between transactions.
GETget_transaction_link
Get a single link.

Webhook, 3 operations

POSTcreate_webhook
Store a new webhook.
DELETEdelete_webhook
Delete a webhook.
GETget_webhook
Get a single webhook.

Attempt, 2 operations

DELETEdelete_webhook_message_attempt
Delete a webhook attempt.
GETget_webhook_message_attempt
Get a single failed attempt from a single webhook message.

Message, 2 operations

DELETEdelete_webhook_message
Delete a webhook message.
GETget_webhook_message
Get a single message from a webhook.

Preference, 2 operations

POSTcreate_preference
Store a new preference for this user.
GETget_preference
Return a single preference.

Recurring, 2 operations

GETautocomplete_recurrences
Returns all recurring transactions of the user returned in a basic auto-complete array.
GETexport_recurring
Export recurring transaction data from Firefly III.

Transaction journal, 2 operations

DELETEdelete_transaction_journal
Delete split from transaction.
GETget_transaction_journal
Get a single transaction, based on one of the underlying transaction journals (transaction splits).

About, 1 operation

GETget_system_information
System information end point.

Asset, 1 operation

GETinsight_expense_asset
Insight into expenses, grouped by asset account.

Available budget, 1 operation

GETget_available_budget
Get a single available budget.

Balance, 1 operation

GETget_balance_chart
Dashboard chart with balance information.

Basic, 1 operation

GETget_basic_summary
Returns basic sums of the users data.

Category, 1 operation

GETinsight_expense_category
Insight into expenses, grouped by category.

Configuration, 1 operation

GETget_configuration_value
Get a single Firefly III system configuration value.

Currencies with code, 1 operation

GETautocomplete_currencies_with_code
Returns all currencies of the user returned in a basic auto-complete array. This endpoint is DEPRECATED and I suggest you DO NOT use it.

Destroy, 1 operation

DELETEdestroy_data
Endpoint to destroy user data.

Disable, 1 operation

POSTdisable_currency
Disable a currency.

Download, 1 operation

GETdownload_attachment
Download a single attachment.

Enable, 1 operation

POSTenable_currency
Enable a single currency.

Expense, 1 operation

GETinsight_expense_expense
Insight into expenses, grouped by expense account.

Finish, 1 operation

POSTfinish_batch
Finish a batch of unprocessed transactions.

No bill, 1 operation

GETinsight_expense_no_bill
Insight into expenses, without bill.

Piggy banks with balance, 1 operation

GETautocomplete_piggy_banks_with_balance
Returns all piggy banks of the user returned in a basic auto-complete array.

Primary, 1 operation

GETget_primary_currency
Get the primary currency of the current administration.

Transaction type, 1 operation

GETautocomplete_transaction_types
Returns all transaction types returned in a basic auto-complete array. English only.

Transactions with id, 1 operation

GETautocomplete_transactions_with_id
Returns all transactions, complemented with their ID, of the user returned in a basic auto-complete array. This endpoint is DEPRECATED and I suggest you DO NOT use it.

User group, 1 operation

GETget_user_group
Get a single user group.

Showing the first 120 of 239 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Firefly III from Claude Code, Cursor or Codex

Connect Firefly III in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Firefly III operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Firefly III

Create your workspace
Sign up free. Nothing to install.
Connect Firefly III once
Add your Firefly III connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Firefly III integration FAQ

What can you do with the Firefly III integration?: LiveContext exposes 239 operations on Firefly III, covering bill, budget, exchange rate and transaction.