Firefly III MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FIREFLY_III_PAT | No | Firefly III OAuth Personal Access Token。亦支持别名 FIREFLY_III_TOKEN。 | |
| FIREFLY_III_URL | No | Firefly III 实例地址(如 http://localhost:8080 或 https://money.example.com,兼容自动去除末尾 /api/v1)。亦支持别名 FIREFLY_BASE_URL。 | |
| FIREFLY_BASE_URL | No | FIREFLY_III_URL 的别名。Firefly III 实例地址(如 http://localhost:8080 或 https://money.example.com,兼容自动去除末尾 /api/v1)。 | |
| FIREFLY_III_TOKEN | No | FIREFLY_III_PAT 的别名。Firefly III OAuth Personal Access Token。 | |
| FIREFLY_III_TIMEOUT_MS | No | 请求超时时间(毫秒),默认 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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.
|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
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.
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.
With 15 tools, the server is well-scoped for account and transaction management. Each tool appears to earn its place without excessive surface area.
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.