接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @daften/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add daften-fireflyiii-mcp -- npx -y @daften/fireflyiii-mcp@1.0.1在終端機中執行。
{ "mcpServers": { "daften-fireflyiii-mcp": { "command": "npx", "args": [ "-y", "@daften/[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
An MCP (Model Context Protocol) server that connects any MCP-compatible AI assistant to your Firefly III personal finance instance. Ask your AI assistant questions about your finances in natural language.
Once configured, you can ask things like:
Your AI assistant handles the Firefly III API calls — you get answers in plain language.
Choose your setup method:
All options except Docker require Node.js 22.12+.
Requires: Node.js 22.12+, a Firefly III Personal Access Token (Options → Remote access and tokens → Create new token).
Add to your Claude MCP config (.claude/mcp.json or Claude Desktop claude_desktop_config.json):
{
"mcpServers": {
"fireflyiii": {
"command": "npx",
"args": ["-y", "@daften/fireflyiii-mcp"],
"env": {
"FIREFLY_URL": "https://your-firefly-instance.example.com",
"FIREFLY_TOKEN": "your-personal-access-token-here"
}
}
}
}
Your MCP client downloads and starts the server automatically on first use. No separate install step needed.
Claude Desktop users: this stdio form is the recommended setup. Claude Desktop's config file does not accept HTTP servers — see the Claude Desktop guide if you need a remote setup.
→ See the HTTP/OAuth setup guide, or HTTP/PAT for headless callers (gateways, automation) that can't drive a browser-based OAuth flow.
→ See Docker setup guide in the docs.
→ See Git checkout guide in the docs.
Want to test unreleased changes from main? A nightly build is published automatically each night that main has changed. These are unstable and not recommended for production.
npm install @daften/fireflyiii-mcp@nightly (or npx @daften/fireflyiii-mcp@nightly)docker pull ghcr.io/daften/fireflyiii-mcp:nightlyA normal install (no tag) always resolves to the latest tagged release — @latest on npm and :latest on Docker are never moved to a nightly. To go back to a stable build, reinstall without the @nightly / :nightly tag.
→ See Autocomplete prompts in the docs.
→ See the full tool reference in the docs (140 tools across 14 groups).
→ See Tool filtering in the docs.
npm test # Run unit tests
npm run test:watch # Watch mode
npm run test:integration # Run against live Firefly III (requires FIREFLY_URL + FIREFLY_TOKEN)
npm run dev # Run without building (uses tsx)
npm run build # Compile TypeScript to dist/
curl -s "https://api-docs.firefly-iii.org/firefly-iii-6.5.5-v1.yaml" -A "Mozilla/5.0" (direct browser access blocked by bot protection)See CONTRIBUTING.md for the development loop, tool-add checklist, and commit conventions.
See SECURITY.md for the vulnerability disclosure policy.
Feature comparison informed by fabianonetto/mcp-server-firefly-iii and etnperlong/firefly-iii-mcp.
MIT
{ "mcpServers": { "daften-fireflyiii-mcp": { "command": "npx", "args": [ "-y", "@daften/[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
@daften/fireflyiii 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 MCP server for Firefly III personal finance manager