Skip to main content
Glama
Firefly III MCP Server

Firefly III MCP Server

by edmondxie779

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FIREFLY_III_PATNoFirefly III OAuth Personal Access Token。亦支持别名 FIREFLY_III_TOKEN。
FIREFLY_III_URLNoFirefly III 实例地址(如 http://localhost:8080 或 https://money.example.com,兼容自动去除末尾 /api/v1)。亦支持别名 FIREFLY_BASE_URL。
FIREFLY_BASE_URLNoFIREFLY_III_URL 的别名。Firefly III 实例地址(如 http://localhost:8080 或 https://money.example.com,兼容自动去除末尾 /api/v1)。
FIREFLY_III_TOKENNoFIREFLY_III_PAT 的别名。Firefly III OAuth Personal Access Token。
FIREFLY_III_TIMEOUT_MSNo请求超时时间(毫秒),默认 30000。30000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_system_infoA

Verify connectivity to Firefly III and retrieve instance version, API version, and authenticated user profile.

get_financial_summaryA

Retrieve Firefly III's basic financial summary (net worth, balance, earned, spent, bills, left to spend) for a given date range.

list_accountsA

List Firefly III accounts and their balances. Filter by account type (e.g. 'asset' for bank/checking/savings/credit cards, 'expense' for merchants, 'revenue' for income sources, 'liability' for loans/debts).

get_accountA

Get detailed attributes and current balance for a single Firefly III account by its ID.

search_accountsA

Search Firefly III accounts by name, account number, IBAN, or ID.

create_accountA

Create a new account in Firefly III. For 'asset' accounts, 'account_role' defaults to 'defaultAsset' (if 'ccAsset', also pass 'credit_card_type' and 'monthly_payment_date'). For 'liability' accounts, 'liability_type' ('loan', 'debt', or 'mortgage') is required.

update_accountB

Update an existing Firefly III account by ID. Only fields you pass will be modified (if 'name' is omitted, the existing account name is preserved automatically).

delete_accountA

Permanently delete a Firefly III account by ID. Warning: deleting an account may also affect or delete transactions exclusively linked to it.

list_account_transactionsB

List transactions associated with a specific Firefly III account ID, optionally filtered by date range and transaction type.

list_transactionsB

List Firefly III transactions with optional date range ('start', 'end' in YYYY-MM-DD) and transaction type filter ('withdrawal', 'deposit', 'transfer', or 'all').

get_transactionA

Retrieve a single Firefly III transaction group and all of its journal splits by transaction ID.

search_transactionsA

Search Firefly III transactions using Firefly III's search query syntax. Multiple terms are combined with AND. Wrap multi-word values in quotes. Useful operators: type:withdrawal|deposit|transfer, date_after:YYYY-MM-DD, date_before:YYYY-MM-DD, date_is:YYYY-MM-DD, amount_is:N, amount_more:N, amount_less:N, source_is:"Checking", destination_is:"Amazon", category_is:"Food", budget_is:"Groceries", tag_is:"trip", description_contains:"coffee", notes_contain:"reimburse", has_any_category:false, reconciled:true. Prefix any filter with '-' to negate.

create_transactionA

Record a new transaction (or multi-split transaction group) in Firefly III.

  • For an expense ('withdrawal'): specify your asset account via 'source_id' or 'source_name', and the merchant via 'destination_name' (or 'destination_id').

  • For income ('deposit'): specify the payer/revenue source via 'source_name' (or 'source_id'), and your asset account via 'destination_id' or 'destination_name'.

  • For a transfer ('transfer'): specify both 'source_id'/'source_name' and 'destination_id'/'destination_name' pointing to two of your own asset/liability accounts.

update_transactionA

Update an existing Firefly III transaction group by ID. When updating a multi-split transaction, pass 'transaction_journal_id' inside each split (retrieve them first with 'get_transaction').

delete_transactionA

Permanently delete a Firefly III transaction group (and all of its splits) by transaction ID.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.9/5.0

Scored across 15 tools

Disambiguation4/5

Tools are mostly distinct: account CRUD, transaction CRUD, search, and summary have clear purposes. A few pairs, such as list_accounts vs. search_accounts and list_transactions vs. search_transactions, could be confused, but descriptions clarify the differences.

Naming Consistency5/5

All tool names use a consistent snake_case verb_noun pattern such as get_account, create_transaction, and delete_account. The naming is predictable and easy to scan.

Tool Count5/5

With 15 tools, the server is well-scoped for account and transaction management. Each tool appears to earn its place without excessive surface area.

Completeness4/5

Account and transaction CRUD, search, listing, and financial summary are well covered. Broader Firefly III entities like budgets, categories, tags, and bills are not managed, but core workflows are still supported.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues