Firefly III MCP サーバー

npm version License: MIT

Firefly III 個人財務インスタンスへのフルアクセスをClaudeに提供するMCP（Model Context Protocol）サーバーです。Claudeと自然言語で会話するだけで、経費の記録、残高確認、予算管理などが行えます。

機能

取引: 取引（出金、入金、振替）の作成、一覧表示、検索、更新、削除
口座: 資産、経費、収益、負債、現金口座の管理
カテゴリ: カテゴリによる取引の整理
予算: 自動予算サポートを含む予算の作成と管理
タグ: 柔軟なタグによる取引のラベル付け

前提条件

Node.js >= 18
実行中のFirefly IIIインスタンス
Firefly IIIインスタンスのパーソナルアクセストークン（PAT）

PATの取得方法

Firefly IIIインスタンスにログイン
Options → Profile → OAuth に移動
Personal Access Tokens で新しいトークンを作成
トークンをコピー（設定時に必要になります）

インストール

npm経由（推奨）

npm install -g firefly-iii-mcp-server

ソースから

git clone https://github.com/przbadu/firefly-iii-mcp-server.git
cd firefly-iii-mcp-server
npm install
npm run build

設定

Claude Desktop

Claude Desktopの設定ファイルを編集します：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

npmでインストールしたバイナリを使用する場合：

{
  "mcpServers": {
    "firefly-iii": {
      "command": "firefly-iii-mcp-server",
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

またはnpxを使用する場合（グローバルインストール不要）：

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Claude Code CLI

claude mcp add firefly-iii \
  -e FIREFLY_III_URL=https://your-firefly-instance.example.com \
  -e FIREFLY_III_PAT=your-personal-access-token-here \
  -- npx -y firefly-iii-mcp-server

または .claude/settings.json に追加します：

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

使用例

設定が完了したら、Claudeと自然に会話するだけです：

取引の記録

"今日、Trader Joe'sで食料品に45.50ドル使った"

"給与2,500ドルの入金をチェック口座に記録して"

"チェック口座から貯蓄口座へ500ドル振り替えて"

クエリ

"先週の取引をすべて見せて"

"今月、レストランにいくら使った？"

"チェック口座の残高はいくら？"

財務管理

"月額600ドルの食費予算を作成して"

"すべての経費カテゴリをリストアップして"

"直近のレストランでの取引3件に「ビジネスランチ」というタグを付けて"

利用可能なツール

ツール	説明
`firefly_create_transaction`	出金、入金、または振替の作成
`firefly_list_transactions`	フィルター付きの取引一覧表示
`firefly_get_transaction`	IDによる取引詳細の取得
`firefly_update_transaction`	既存の取引の更新
`firefly_delete_transaction`	取引の削除
`firefly_search_transactions`	Firefly IIIクエリ構文による検索
`firefly_create_account`	新しい口座の作成
`firefly_list_accounts`	タイプ別の口座一覧表示
`firefly_get_account`	口座詳細の取得
`firefly_update_account`	口座プロパティの更新
`firefly_delete_account`	口座の削除
`firefly_list_categories`	すべてのカテゴリのリスト表示
`firefly_create_category`	カテゴリの作成
`firefly_update_category`	カテゴリの更新
`firefly_delete_category`	カテゴリの削除
`firefly_list_budgets`	すべての予算のリスト表示
`firefly_create_budget`	予算の作成
`firefly_update_budget`	予算の更新
`firefly_delete_budget`	予算の削除
`firefly_list_tags`	すべてのタグのリスト表示
`firefly_create_tag`	タグの作成
`firefly_update_tag`	タグの更新
`firefly_delete_tag`	タグの削除

開発

# Watch mode with auto-reload
npm run dev

# Build for production
npm run build

# Run the built server
npm start

ライセンス

MIT

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - A tier

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Firefly III MCP Server