@firefly-iii-mcp/server

What it does

This Express-based MCP server bridges Claude and other AI tools with Firefly III, a self-hosted personal finance manager. It exposes read and write access to financial accounts, transactions, categories, budgets, and other financial data, enabling AI assistants to query account balances, create transactions, categorize spending, and generate financial summaries on demand.

Who it's for

Individuals who self-host Firefly III and want to use Claude or other Claude-powered tools to interact with their finances programmatically. Also useful for developers building AI-augmented financial management applications on top of Firefly III.

Common use cases

• Query account balances and recent transaction history via natural language
• Create or modify transactions and financial records through Claude
• Ask Claude to summarize spending by category or generate budget analysis
• Automate financial workflows by triggering account operations from chat
• Build AI assistants that understand and manage personal finances in real time

Setup pitfalls

• Requires a running Firefly III instance — the MCP server itself is just a bridge. If you don't self-host Firefly III, this server won't work.
• Personal Access Token (PAT) must be kept secure. Avoid passing it in query parameters; use request headers or environment variables instead. If using the HTTP server in production, ensure HTTPS to prevent token interception.
• Reads and writes filesystem and makes network calls — sandbox or restrict the server's network access if running alongside untrusted code.
• Project had its last commit 349 days ago; verify current maintenance status and compatibility with your Firefly III version before deploying to production.