Integration

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.

Connect Firefly III How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Firefly III.Built from the 239 Firefly III tools below, on the connection you add once.

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

autocomplete_billsAutocomplete billsGETReturns all bills of the user returned in a basic auto-complete array.
create_billCreate billPOSTStore a new bill.
delete_billDelete billDELETEDelete a bill.
export_billsExport billsGETExport bills from Firefly III.
get_billGet billGETGet a single bill.
insight_expense_billInsight expense billGETInsight into expenses, grouped by bill.

Budget, 6 operations

autocomplete_budgetsAutocomplete budgetsGETReturns all budgets of the user returned in a basic auto-complete array.
create_budgetCreate budgetPOSTStore a new budget.
delete_budgetDelete budgetDELETEDelete a budget.
export_budgetsExport budgetsGETExport budgets and budget amount data from Firefly III.
get_budgetGet budgetGETGet a single budget.
insight_expense_budgetInsight expense budgetGETInsight into expenses, grouped by budget.

Exchange rate, 6 operations

create_exchange_rateCreate exchange ratePOSTStore a new currency exchange rate.
delete_exchange_rateDelete exchange rateDELETEDelete a specific currency exchange rate.
delete_exchange_rate_for_dateDelete exchange rate for dateDELETEDelete the currency exchange rate from 'from' to 'to' on the specified date.
delete_exchange_rates_for_currency_pairDelete exchange rates for currency pairDELETEDeletes ALL currency exchange rates from 'from' to 'to'.
get_exchange_rateGet exchange rateGETList a single specific exchange rate.
get_exchange_rate_for_dateGet exchange rate for dateGETList the exchange rate for the from and to-currency on the requested date.

Transaction, 6 operations

autocomplete_transactionsAutocomplete transactionsGETReturns all transaction descriptions of the user returned in a basic auto-complete array.
bulk_update_transactionsBulk update transactionsPOSTBulk update transaction properties. For more information, see https://docs.firefly-iii.org/references/firefly-iii/api/specials/.
create_transactionCreate transactionPOSTStore a new transaction.
delete_transactionDelete transactionDELETEDelete a transaction.
export_transactionsExport transactionsGETExport transaction data from Firefly III.
get_transactionGet transactionGETGet a single transaction.

Account, 5 operations

autocomplete_accountsAutocomplete accountsGETReturns all accounts of the user returned in a basic auto-complete array.
create_accountCreate accountPOSTCreate new account.
delete_accountDelete accountDELETEPermanently delete account.
export_accountsExport accountsGETExport account data from Firefly III.
get_accountGet accountGETGet single account.

Categorie, 5 operations

autocomplete_categoriesAutocomplete categoriesGETReturns all categories of the user returned in a basic auto-complete array.
create_categoryCreate categoryPOSTStore a new category.
delete_categoryDelete categoryDELETEDelete a category.
export_categoriesExport categoriesGETExport category data from Firefly III.
get_categoryGet categoryGETGet a single category.

Piggy bank, 5 operations

autocomplete_piggy_banksAutocomplete piggy banksGETReturns all piggy banks of the user returned in a basic auto-complete array.
create_piggy_bankCreate piggy bankPOSTStore a new piggy bank.
delete_piggy_bankDelete piggy bankDELETEDelete a piggy bank.
export_piggy_banksExport piggy banksGETExport piggy banks from Firefly III.
get_piggy_bankGet piggy bankGETGet a single piggy bank.

Rule, 5 operations

autocomplete_rulesAutocomplete rulesGETReturns all rules of the user returned in a basic auto-complete array.
create_ruleCreate rulePOSTStore a new rule.
delete_ruleDelete ruleDELETEDelete an rule.
export_rulesExport rulesGETExport rule groups and rule data from Firefly III.
get_ruleGet ruleGETGet a single rule.

Subscription, 5 operations

autocomplete_subscriptionsAutocomplete subscriptionsGETReturns all subscriptions of the user returned in a basic auto-complete array.
create_subscriptionCreate subscriptionPOSTStore a new subscription.
delete_subscriptionDelete subscriptionDELETEDelete a subscription.
export_subscriptionsExport subscriptionsGETExport subscriptions from Firefly III.
get_subscriptionGet subscriptionGETGet a single subscription.

Tag, 5 operations

autocomplete_tagsAutocomplete tagsGETReturns all tags of the user returned in a basic auto-complete array.
create_tagCreate tagPOSTStore a new tag.
delete_tagDelete tagDELETEDelete an tag.
export_tagsExport tagsGETExport tag data from Firefly III.
get_tagGet tagGETGet a single tag.

Currencie, 4 operations

autocomplete_currenciesAutocomplete currenciesGETReturns all currencies of the user returned in a basic auto-complete array.
create_currencyCreate currencyPOSTStore a new currency.
delete_currencyDelete currencyDELETEDelete a currency.
get_currencyGet currencyGETGet a single currency.

Rule group, 4 operations

autocomplete_rule_groupsAutocomplete rule groupsGETReturns all rule groups of the user returned in a basic auto-complete array.
create_rule_groupCreate rule groupPOSTStore a new rule group.
delete_rule_groupDelete rule groupDELETEDelete a rule group.
get_rule_groupGet rule groupGETGet a single rule group.

User, 4 operations

create_userCreate userPOSTStore a new user.
delete_userDelete userDELETEDelete a user.
get_authenticated_userGet authenticated userGETCurrently authenticated user endpoint.
get_userGet userGETGet a single user.

Attachment, 3 operations

create_attachmentCreate attachmentPOSTStore a new attachment.
delete_attachmentDelete attachmentDELETEDelete an attachment.
get_attachmentGet attachmentGETGet a single attachment.

Limit, 3 operations

create_budget_limitCreate budget limitPOSTStore new budget limit.
delete_budget_limitDelete budget limitDELETEDelete a budget limit.
get_budget_limitGet budget limitGETGet single budget limit.

Link type, 3 operations

create_link_typeCreate link typePOSTCreate a new link type.
delete_link_typeDelete link typeDELETEPermanently delete link type.
get_link_typeGet link typeGETGet single a link type.

Object group, 3 operations

autocomplete_object_groupsAutocomplete object groupsGETReturns all object groups of the user returned in a basic auto-complete array.
delete_object_groupDelete object groupDELETEDelete a object group.
get_object_groupGet object groupGETGet a single object group.

Overview, 3 operations

get_account_chartGet account chartGETDashboard chart with asset account balance information.
get_budget_chartGet budget chartGETDashboard chart with budget information.
get_category_chartGet category chartGETDashboard chart with category information.

Recurrence, 3 operations

create_recurrenceCreate recurrencePOSTStore a new recurring transaction.
delete_recurrenceDelete recurrenceDELETEDelete a recurring transaction.
get_recurrenceGet recurrenceGETGet a single recurring transaction.

Transaction link, 3 operations

create_transaction_linkCreate transaction linkPOSTCreate a new link between transactions.
delete_transaction_linkDelete transaction linkDELETEPermanently delete link between transactions.
get_transaction_linkGet transaction linkGETGet a single link.

Webhook, 3 operations

create_webhookCreate webhookPOSTStore a new webhook.
delete_webhookDelete webhookDELETEDelete a webhook.
get_webhookGet webhookGETGet a single webhook.

Attempt, 2 operations

delete_webhook_message_attemptDelete webhook message attemptDELETEDelete a webhook attempt.
get_webhook_message_attemptGet webhook message attemptGETGet a single failed attempt from a single webhook message.

Message, 2 operations

delete_webhook_messageDelete webhook messageDELETEDelete a webhook message.
get_webhook_messageGet webhook messageGETGet a single message from a webhook.

Preference, 2 operations

create_preferenceCreate preferencePOSTStore a new preference for this user.
get_preferenceGet preferenceGETReturn a single preference.

Recurring, 2 operations

autocomplete_recurrencesAutocomplete recurrencesGETReturns all recurring transactions of the user returned in a basic auto-complete array.
export_recurringExport recurringGETExport recurring transaction data from Firefly III.

Transaction journal, 2 operations

delete_transaction_journalDelete transaction journalDELETEDelete split from transaction.
get_transaction_journalGet transaction journalGETGet a single transaction, based on one of the underlying transaction journals (transaction splits).

About, 1 operation

get_system_informationGet system informationGETSystem information end point.

Asset, 1 operation

insight_expense_assetInsight expense assetGETInsight into expenses, grouped by asset account.

Available budget, 1 operation

get_available_budgetGet available budgetGETGet a single available budget.

Balance, 1 operation

get_balance_chartGet balance chartGETDashboard chart with balance information.

Basic, 1 operation

get_basic_summaryGet basic summaryGETReturns basic sums of the users data.

Category, 1 operation

insight_expense_categoryInsight expense categoryGETInsight into expenses, grouped by category.

Configuration, 1 operation

get_configuration_valueGet configuration valueGETGet a single Firefly III system configuration value.

Currencies with code, 1 operation

autocomplete_currencies_with_codeAutocomplete currencies with codeGETReturns 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

destroy_dataDestroy dataDELETEEndpoint to destroy user data.

Disable, 1 operation

disable_currencyDisable currencyPOSTDisable a currency.

Download, 1 operation

download_attachmentDownload attachmentGETDownload a single attachment.

Enable, 1 operation

enable_currencyEnable currencyPOSTEnable a single currency.

Expense, 1 operation

insight_expense_expenseInsight expense expenseGETInsight into expenses, grouped by expense account.

Finish, 1 operation

finish_batchFinish batchPOSTFinish a batch of unprocessed transactions.

No bill, 1 operation

insight_expense_no_billInsight expense no billGETInsight into expenses, without bill.

Piggy banks with balance, 1 operation

autocomplete_piggy_banks_with_balanceAutocomplete piggy banks with balanceGETReturns all piggy banks of the user returned in a basic auto-complete array.

Primary, 1 operation

get_primary_currencyGet primary currencyGETGet the primary currency of the current administration.

Transaction type, 1 operation

autocomplete_transaction_typesAutocomplete transaction typesGETReturns all transaction types returned in a basic auto-complete array. English only.

Transactions with id, 1 operation

autocomplete_transactions_with_idAutocomplete transactions with idGETReturns 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

get_user_groupGet user groupGETGet 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.