プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Actual Budget MCP Server

作者:s-stefanovバージョン 1.15.1i★ 291iパソコンで動くリポジトリ ↗
レジストリ名io.github.s-stefanov/actual-mcp

インストール方法

What it does

MCP server exposing Actual Budget accounts, transactions, budgets and reporting to LLM assistants.

  • Connects パソコンで動く
  • Account or key Needs ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD · 2 settings to fill in (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID)
  • Category 会計・財務・税務

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気36/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア48/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: 3 (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Actual Budget MCP Server をインストールして。https://mcp.popnx.com/i/s-stefanov-actual-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server Actual Budget MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "actual": { "command": "npx", "args": [ "-y", "actual-mcp" ], "env": { "ACTUAL_SERVER_URL": "your-value", "ACTUAL_PASSWORD": "your-value", "ACTUAL_BUDGET_SYNC_ID": "your-value", "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Actual Budget MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Actual Budget MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Actual Budget MCP Server のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • ACTUAL_SERVER_URL Actual Budget サーバーの URL
      英語の原文を見るURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID 予算同期 ID
      英語の原文を見るBudget sync ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  5. この設定を貼り付けて保存

    {
      "mcpServers": {
        "actual": {
          "command": "npx",
          "args": [
            "-y",
            "actual-mcp"
          ],
          "env": {
            "ACTUAL_SERVER_URL": "your-value",
            "ACTUAL_PASSWORD": "your-value",
            "ACTUAL_BUDGET_SYNC_ID": "your-value",
            "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
          }
        }
      }
    }

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude を終了してもう一度開く

  7. 試してみる

    Actual Budget MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Actual Budget MCP Server を使っていると言うか、回答に Actual Budget MCP Server のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • ACTUAL_DATA_DIR キャッシュされた予算データ用のローカルディレクトリ
    英語の原文を見るLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS 同期キャッシュの TTL(ミリ秒)
    英語の原文を見るSync cache TTL in ms
    · 初期値 60000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Actual Budget MCP Server につなげません

Actual Budget MCP Server はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Actual Budget MCP Server につなげるアプリを使う

  • Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)
  • Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 会計・財務・税務 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server Actual Budget MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user actual --env ACTUAL_SERVER_URL=your-value --env ACTUAL_PASSWORD=your-value --env ACTUAL_BUDGET_SYNC_ID=your-value --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=your-value -- npx -y actual-mcp 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Actual Budget MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Actual Budget MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Actual Budget MCP Server のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • ACTUAL_SERVER_URL Actual Budget サーバーの URL
      英語の原文を見るURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID 予算同期 ID
      英語の原文を見るBudget sync ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  5. このコマンドを貼り付けて Enter

    claude mcp add --scope user actual --env ACTUAL_SERVER_URL=your-value --env ACTUAL_PASSWORD=your-value --env ACTUAL_BUDGET_SYNC_ID=your-value --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=your-value -- npx -y actual-mcp

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Claude Code で /mcp と入力

    Actual Budget MCP Server が一覧にあり、接続済みと表示されれば OK です

  7. 試してみる

    Actual Budget MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Actual Budget MCP Server を使っていると言うか、回答に Actual Budget MCP Server のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • ACTUAL_DATA_DIR キャッシュされた予算データ用のローカルディレクトリ
    英語の原文を見るLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS 同期キャッシュの TTL(ミリ秒)
    英語の原文を見るSync cache TTL in ms
    · 初期値 60000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server Actual Budget MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "actual": { "command": "npx", "args": [ "-y", "actual-mcp" ], "env": { "ACTUAL_SERVER_URL": "your-value", "ACTUAL_PASSWORD": "your-value", "ACTUAL_BUDGET_SYNC_ID": "your-value", "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Actual Budget MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Actual Budget MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Actual Budget MCP Server のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • ACTUAL_SERVER_URL Actual Budget サーバーの URL
      英語の原文を見るURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID 予算同期 ID
      英語の原文を見るBudget sync ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  5. キーを入力

    Actual Budget MCP Server の設定で ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. Cursor の AI チャットを Agent モードで開く

  7. 試してみる

    Actual Budget MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Actual Budget MCP Server を使っていると言うか、回答に Actual Budget MCP Server のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • ACTUAL_DATA_DIR キャッシュされた予算データ用のローカルディレクトリ
    英語の原文を見るLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS 同期キャッシュの TTL(ミリ秒)
    英語の原文を見るSync cache TTL in ms
    · 初期値 60000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

Actual Budget MCP Server のキーが必要です(提供元のサイトで作成) · 設定を 2 項目入力 (ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID) · 先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server Actual Budget MCP Server を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "actual": { "type": "stdio", "command": "npx", "args": [ "-y", "actual-mcp" ], "env": { "ACTUAL_SERVER_URL": "your-value", "ACTUAL_PASSWORD": "your-value", "ACTUAL_BUDGET_SYNC_ID": "your-value", "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、Actual Budget MCP Server のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. Actual Budget MCP Server に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Actual Budget MCP Server のサイトを開く ↗

  3. 設定を 2 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • ACTUAL_SERVER_URL Actual Budget サーバーの URL
      英語の原文を見るURL of your Actual Budget server
    • ACTUAL_BUDGET_SYNC_ID 予算同期 ID
      英語の原文を見るBudget sync ID

    説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

  4. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  5. キーを入力

    Actual Budget MCP Server の設定で ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD, ACTUAL_SERVER_URL, ACTUAL_BUDGET_SYNC_ID が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  6. VS Code の AI チャットを Agent モードで開く

  7. 試してみる

    Actual Budget MCP Server を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Actual Budget MCP Server を使っていると言うか、回答に Actual Budget MCP Server のツール名が出れば接続成功です

追加の設定 2 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • ACTUAL_DATA_DIR キャッシュされた予算データ用のローカルディレクトリ
    英語の原文を見るLocal dir for cached budget data
  • ACTUAL_SYNC_TTL_MS 同期キャッシュの TTL(ミリ秒)
    英語の原文を見るSync cache TTL in ms
    · 初期値 60000

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Actual Budget MCP Server を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user actual --env ACTUAL_SERVER_URL=your-value --env ACTUAL_PASSWORD=your-value --env ACTUAL_BUDGET_SYNC_ID=your-value --env ACTUAL_BUDGET_ENCRYPTION_PASSWORD=your-value -- npx -y actual-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "actual": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_PASSWORD": "your-value",
        "ACTUAL_BUDGET_SYNC_ID": "your-value",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "actual": {
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_PASSWORD": "your-value",
        "ACTUAL_BUDGET_SYNC_ID": "your-value",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "actual": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "actual-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_PASSWORD": "your-value",
        "ACTUAL_BUDGET_SYNC_ID": "your-value",
        "ACTUAL_BUDGET_ENCRYPTION_PASSWORD": "your-value"
      }
    }
  }
}

自分で入力する値

  • ACTUAL_SERVER_URL 必須 env
    Actual Budget サーバーの URL
    英語の原文を見るURL of your Actual Budget server
  • ACTUAL_PASSWORD 秘密 必須 env
    Actual Budget サーバーのパスワード
    英語の原文を見るActual Budget server password
  • ACTUAL_BUDGET_SYNC_ID 必須 env
    予算同期 ID
    英語の原文を見るBudget sync ID
  • ACTUAL_DATA_DIR env
    キャッシュされた予算データ用のローカルディレクトリ
    英語の原文を見るLocal dir for cached budget data
  • ACTUAL_BUDGET_ENCRYPTION_PASSWORD 秘密 必須 env
    E2E 暗号化のパスワード(有効な場合)
    英語の原文を見るE2E encryption password, if enabled
  • ACTUAL_SYNC_TTL_MS env
    同期キャッシュの TTL(ミリ秒)
    英語の原文を見るSync cache TTL in ms

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
672/週
接続方法
パソコンで動く
最新バージョンi
1.15.1
レジストリ公開日i
2026年10月20日
コードの最終更新i
2026年11月18日
作者
s-stefanov
パッケージ
npm: actual-mcp
npm: actual-mcp
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント s-stefanov で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に actual-mcp@1.15.1 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/s-stefanov-actual-mcp.svg)](https://mcp.popnx.com/en/servers/s-stefanov-actual-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

会計・財務・税務のほかのサーバーとの比較i

  • このカテゴリのほかの3407件のうち99%よりスターが多い
  • このカテゴリのほかの3407件のうち51%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの3407件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Actual Budget MCP Serverは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:ACTUAL_PASSWORD, ACTUAL_BUDGET_ENCRYPTION_PASSWORD

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(1.15.1)がレジストリに届いたのは30 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

作者:SolidInvoice成長中★ 98910 日前更新

クラウドで動く✓ 提供元 · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

作者:signal8ai成長中↓ 431/週★ 42510 日前更新

パソコンでもクラウドでも✓ 提供元 · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

作者:Cursivez成長中★ 26111 日前更新

クラウドで動く✓ 提供元 · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

作者:bex-co成長中★ 688 リポジトリ全体のスター44 日前更新

クラウドで動く✓ 提供元 · beancount.io
似たものと比べる
これ
Actual Budget MCP Server
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使える
キーが必要はいいいえはいいいえいいえはい
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/65/54/44/45/5
ライセンスMITMITMITNOASSERTIONMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Actual Budget MCP Server

MCP server for integrating Actual Budget with Claude and other LLM assistants.

Overview

The Actual Budget MCP Server allows you to interact with your personal financial data from Actual Budget using natural language through LLMs. It exposes your accounts, transactions, and financial metrics through the Model Context Protocol (MCP).

Features

Resources
  • Account Listings - Browse all your accounts with their balances
  • Account Details - View detailed information about specific accounts
  • Transaction History - Access transaction data with complete details
Tools
Transaction & Account Management
  • `get-transactions` - Retrieve and filter transactions by account, date, amount, category, or payee
  • `create-transaction` - Create a new transaction in an account with optional category, payee, and notes
  • `update-transaction` - Update an existing transaction with new category, payee, notes, or amount
  • `get-accounts` - Retrieve a list of all accounts with their current balance and ID
  • `balance-history` - View account balance changes over time
Reporting & Analytics
  • `spending-by-category` - Generate spending breakdowns categorized by type
  • `monthly-summary` - Get monthly income, expenses, and savings metrics
  • `budget-vs-actual` - Compare budgeted amounts against actual spending per category
  • `net-worth` - Track assets, liabilities, and net worth across all accounts over time
  • `category-trends` - See how spending in each category moves month over month, with trend direction
  • `spending-by-payee` - Rank payees by how much was spent with (or received from) each one
  • `cash-flow` - Report income, expenses, and net cash flow per month or week

The five tools above return JSON rather than markdown, so amounts stay machine-readable. Every amount is an integer number of cents, and each response carries an amountsIn field describing the sign conventions it uses.

Custom Reports & Dashboards
  • `get-custom-reports` - Retrieve every saved custom report from the Reports section
  • `create-custom-report` - Create a saved custom report
  • `update-custom-report` - Update fields on a saved custom report, leaving the rest unchanged
  • `delete-custom-report` - Delete a saved custom report
  • `get-dashboards` - Retrieve every dashboard page and the widgets laid out on it
  • `add-dashboard-widget` - Add a widget to a dashboard page
  • `update-dashboard-widget` - Update a widget's configuration, position, or size
  • `remove-dashboard-widget` - Remove a widget from its page
  • `organize-dashboard` - Reposition and resize several widgets at once
  • `create-dashboard-page` / `rename-dashboard-page` / `delete-dashboard-page` - Manage dashboard pages
Categories
  • `get-grouped-categories` - Retrieve a list of all category groups with their categories
  • `create-category` - Create a new category within a category group
  • `update-category` - Update an existing category's name or group
  • `delete-category` - Delete a category
  • `create-category-group` - Create a new category group
  • `update-category-group` - Update a category group's name
  • `delete-category-group` - Delete a category group
Payees
  • `get-payees` - Retrieve a list of all payees with their details
  • `create-payee` - Create a new payee
  • `update-payee` - Update an existing payee's details
  • `delete-payee` - Delete a payee
  • `merge-payees` - Merge duplicate payees into a single target payee
Rules
  • `get-rules` - Retrieve a list of all transaction rules
  • `create-rule` - Create a new transaction rule with conditions and actions
  • `update-rule` - Update an existing transaction rule
  • `delete-rule` - Delete a transaction rule
Prompts
  • `financial-insights` - Generate insights and recommendations based on your financial data
  • `budget-review` - Analyze your budget compliance and suggest adjustments

Installation

Prerequisites
Remote access

Pull the latest docker image:

docker pull sstefanov/actual-mcp:latest
Local setup
  1. Clone the repository:
git clone https://github.com/s-stefanov/actual-mcp.git

cd actual-mcp

  1. Install dependencies:
npm install
  1. Build the server:
npm run build
  1. Build the local docker image (optional):
docker build -t <local-image-name> .
  1. Configure environment variables (optional):
# Path to your Actual Budget data directory (default: ~/.actual)

export ACTUAL_DATA_DIR="/path/to/your/actual/data"

If using a remote Actual server

export ACTUAL_SERVER_URL="https://your-actual-server.com" export ACTUAL_PASSWORD="your-password"

Specific budget to use (optional)

export ACTUAL_BUDGET_SYNC_ID="your-budget-id"

How long downloaded data stays fresh before the server re-syncs, in ms

(default: 60000). Use 0 to sync before every call, or -1 to never sync.

export ACTUAL_SYNC_TTL_MS="60000"

Optional: separate encryption budget password

If your Actual setup requires a different password to unlock the local/encrypted budget data than the server authentication password, you can set ACTUAL_BUDGET_ENCRYPTION_PASSWORD in addition to ACTUAL_PASSWORD.

# If server auth and encryption/unlock use different passwords

export ACTUAL_BUDGET_ENCRYPTION_PASSWORD="your-encryption-password"

Optional: OpenID servers (session token auth)

If your Actual server uses OpenID login (for example Google) with ACTUAL_OPENID_ENFORCE=true, password login is disabled, so ACTUAL_PASSWORD can't be used. Instead, sign in to Actual in a browser and pass the resulting session token. It takes precedence over ACTUAL_PASSWORD.

export ACTUAL_SERVER_URL="https://your-actual-server.com"

export ACTUAL_SESSION_TOKEN="your-session-token"

To find the token, sign in to Actual in your browser, open DevTools, and go to Application → IndexedDB → actual → asyncStorage. The value of the user-token key is your session token. It's a UUID (e.g. 3f2b8c1e-9a4d-4e7b-8c2a-1d5e6f7a8b9c), not a long JWT-style bearer token. You can check it with curl -H "X-ACTUAL-TOKEN: " https://your-actual-server.com/account/validate, which should return "validated": true. Treat it like a password: it grants full access to your budgets. How long it stays valid depends on the server's ACTUAL_TOKEN_EXPIRATION setting. If it is invalid or expired, the MCP server still starts, but tool calls fail with Authentication failed: invalid or expired session token, because the server connects to Actual on the first request (--test-resources reports the error immediately). Sign in again, replace the token, and restart the MCP server.

Connection lifecycle

The server keeps one shared Actual connection for its entire lifetime and serializes budget operations through it. Downloaded data is re-synced when it exceeds the ACTUAL_SYNC_TTL_MS freshness window. In both stdio and HTTP modes, SIGINT and SIGTERM drain in-flight work before the server shuts down. Actual is no longer initialized and shut down for each tool call.

Report semantics
  • Balances and balance histories are capped as of today; future-dated transactions are excluded, and the current-month balance-history row is partial.
  • Closed on-budget accounts remain included in historical reports; closed off-budget accounts stay excluded by default.
  • Monthly income follows Actual's income-group metadata. Refunds net against expenses, zero-activity months count in averages, and uncategorized transfer pairs are skipped.
  • The former Investments bucket is removed from monthly summaries.

Usage with Claude Desktop

To use this server with Claude Desktop, add it to your Claude configuration:

On MacOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add the following to your configuration...

a. Using Node.js (npx version):
{

"mcpServers": { "actualBudget": { "command": "npx", "args": ["-y", "actual-mcp", "--enable-write"], "env": { "ACTUAL_DATA_DIR": "path/to/your/data", "ACTUAL_PASSWORD": "your-password", "ACTUAL_SERVER_URL": "http://your-actual-server.com", "ACTUAL_BUDGET_SYNC_ID": "your-budget-id" } } } }

a. Using Node.js (local only):
{

"mcpServers": { "actualBudget": { "command": "node", "args": ["/path/to/your/clone/build/index.js", "--enable-write"], "env": { "ACTUAL_DATA_DIR": "path/to/your/data", "ACTUAL_PASSWORD": "your-password", "ACTUAL_SERVER_URL": "http://your-actual-server.com", "ACTUAL_BUDGET_SYNC_ID": "your-budget-id" } } } }

b. Using Docker (local or remote images):
{

"mcpServers": { "actualBudget": { "command": "docker", "args": [ "run", "-i", "--rm", "-v", "/path/to/your/data:/data", "-e", "ACTUAL_PASSWORD=your-password", "-e", "ACTUAL_SERVER_URL=https://your-actual-server.com", "-e", "ACTUAL_BUDGET_SYNC_ID=your-budget-id", "sstefanov/actual-mcp:latest", "--enable-write" ] } } }

After saving the configuration, restart Claude Desktop.

💡 ACTUAL_DATA_DIR is optional if you're using ACTUAL_SERVER_URL.

💡 Use --enable-write to enable write-access tools.

Running an SSE Server

To expose the server over a port using Docker:

docker run -i --rm \

-p 3000:3000 \ -v "/path/to/your/data:/data" \ -e ACTUAL_PASSWORD="your-password" \ -e ACTUAL_SERVER_URL="http://your-actual-server.com" \ -e ACTUAL_BUDGET_SYNC_ID="your-budget-id" \ -e BEARER_TOKEN="your-bearer-token" \ sstefanov/actual-mcp:latest \ --sse --enable-write --enable-bearer

⚠️ Important: When using --enable-bearer, the BEARER_TOKEN environment variable must be set.

🔒 This is highly recommended if you're exposing your server via a public URL.

Example Queries

Once connected, you can ask Claude questions like:

  • "What's my current account balance?"
  • "Show me my spending by category last month"
  • "How much did I spend on groceries in January?"
  • "What's my savings rate over the past 3 months?"
  • "Which categories am I overspending on this month?"
  • "How has my net worth changed over the past year?"
  • "Which payees do I spend the most with?"
  • "Is my grocery spending trending up or down?"
  • "Analyze my budget and suggest areas to improve"
  • "What custom reports do I have?"
  • "Add a net worth widget to my Spending Plan dashboard"
  • "Rearrange my dashboard so the cash flow card is full width at the top"

Usage with Codex CLI

Example Codex configuration:

In ~/.codex/config.toml:

[mcp_servers.actual-budget]

url = "http://localhost:3000"

Point Codex at the same port you pass to npm start -- --sse --port .

Development

For development with auto-rebuild:

npm run watch
Testing the connection to Actual

To verify the server can connect to your Actual Budget data:

node build/index.js --test-resources
Debugging

Since MCP servers communicate over stdio, debugging can be challenging. You can use the MCP Inspector:

npx @modelcontextprotocol/inspector node build/index.js
E2E validation gate

The end-to-end test suite (vitest.e2e.config.ts) spins up a real Actual B

冒頭だけを表示しています。続きはリポジトリで読めます