Firefly III MCP Server
Provides tools for interacting with a Firefly III personal finance instance via its API: checking connectivity and current user, retrieving financial overviews (net worth, income/expense totals, bills due, available balance), managing accounts (listing, searching, creating, updating, deleting, viewing balances and transaction history), and managing transactions (listing, searching with Firefly III's advanced search syntax, retrieving, creating withdrawals/deposits/transfers including split transactions, multi-currency, categories, budgets and tags, updating and deleting).
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Firefly III MCP Server (firefly-iii-mcp)
适用于 Firefly III 个人财务管理系统的标准 Model Context Protocol (MCP) 服务端(TypeScript / Node.js)。支持在 Claude Desktop、Cursor、Antigravity、Windsurf 等任意兼容 MCP 的客户端中通过自然语言查账、管账户、记账与搜索流水。
功能特性(Tools)
系统与财务概览
Tool | 说明 |
| 检查与 Firefly III 实例的连通性,返回系统版本、API 版本及当前登录用户信息 |
| 获取指定日期范围内的财务概览(净资产、收支汇总、待付账单、可支配余额等) |
账户管理(Accounts)
Tool | 说明 |
| 查询账户列表及余额(支持按 |
| 根据账户 ID 获取单个账户详情与余额 |
| 按名称、卡号/账号、IBAN 或 ID 搜索账户 |
| 创建新账户(自动为资产账户补充默认 |
| 更新账户信息(支持部分字段更新,未传 |
| 根据 ID 删除账户 |
| 查询指定账户名下的交易流水(支持日期范围与交易类型筛选) |
交易记录(Transactions)
Tool | 说明 |
| 按日期范围( |
| 获取单笔(或拆分交易组)的完整明细 |
| 使用 Firefly III 高级搜索语法检索交易(例如 |
| 创建支出( |
| 修改已有交易记录或拆分明细 |
| 删除指定交易记录 |
Related MCP server: Firefly III MCP Server
前置准备:获取 Firefly III Personal Access Token
登录你的 Firefly III 网页端。
进入 Options(选项) -> Profile(个人资料) -> OAuth 页面。
在 Personal Access Tokens 区域点击 Create New Token,输入名称(例如
MCP Server)并复制生成的长 Token。
本地构建与运行
环境要求:Node.js >= 20
# 安装依赖
npm install
# 编译 TypeScript 到 dist/
npm run build
# 运行单元测试与 MCP 协议集成测试
npm test在 MCP 客户端中配置
方式一:直接使用本地构建产物
{
"mcpServers": {
"firefly-iii": {
"command": "node",
"args": ["/path/to/firefly-iii-mcp/dist/index.js"],
"env": {
"FIREFLY_III_URL": "https://your-firefly-instance.example.com",
"FIREFLY_III_PAT": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9..."
}
}
}
}方式二:发布到 npm 后通过 npx 启动
{
"mcpServers": {
"firefly-iii": {
"command": "npx",
"args": ["-y", "firefly-iii-mcp"],
"env": {
"FIREFLY_III_URL": "https://your-firefly-instance.example.com",
"FIREFLY_III_PAT": "your_personal_access_token"
}
}
}
}环境变量说明
变量名 | 必填 | 说明 |
| 是 | Firefly III 实例地址(如 |
| 是 | Firefly III OAuth Personal Access Token。亦支持别名 |
| 否 | 请求超时时间(毫秒),默认 |
许可协议
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Log, query, and edit expenses, budgets, and accounts in Manilo from any MCP-compatible AI assistant.
Log, query, and edit expenses, budgets, and accounts in Manilo (formerly Ledgy) from any MCP-compatible AI assistant.
Log, query, and edit expenses, budgets, and accounts in Ledgy from any MCP-compatible AI assistant.
Personal finance for AI agents — onboard, import statements, categorize & budget over MCP.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables AI tools to interact with Firefly III personal finance management instances through a cloud-deployed MCP server. Supports financial operations like account management, transactions, budgeting, and reporting with configurable tool presets.19 npm-
- AlicenseAqualityDmaintenanceIntegrates with Firefly III personal finance software to enable natural language management of transactions, accounts, budgets, and categories. Supports recording expenses, checking balances, and organizing financial data through conversational AI.237 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables querying personal finance data including accounts, transactions, spending, holdings, net worth, and budgets from your self-hosted OpenCoffer instance. Supports natural language queries through any MCP-compatible client.19MIT
- AlicenseNot gradedqualityCmaintenanceConnects any MCP-compatible AI assistant to your Firefly III personal finance instance, enabling natural language queries about your finances.MIT