プロトタイプ · プレビュー版：公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説
☰ メニュー日本語 設定
初心者モード オン
配色システムに合わせるライトホワイトダーク
言語ไทยEnglish中文日本語한국어EspañolDeutsch

Actual Budget

作者：henfrydlsバージョン 0.12.0i★ 20iパソコンで動く
レジストリ名io.github.henfrydls/actual-budget-mcp

インストール方法

What it does

Actual Budget, carefully: deletes preview first, and new transactions check for duplicates.

  • Connects パソコンで動く
  • Account or key Needs ACTUAL_SESSION_TOKEN, ACTUAL_ENCRYPTION_PASSWORD, ACTUAL_ENCRYPTION_PASSWORDS, ACTUAL_HTTP_TOKEN, ACTUAL_HTTP_WRITE_TOKEN · 2 settings to fill in (ACTUAL_SERVER_URL, ACTUAL_BUDGET_ID)
  • Category 会計・財務・税務

インストール

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

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

まず：どの AI を使っていますか？

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

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

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

  1. Node.js を入れる

    1 回だけ。Node.js が必要なすべてのサーバーで使えます

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

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

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

    Actual Budget のサイトを開く ↗

  3. 設定を 2 項目入力

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

    • ACTUAL_SERVER_URL URL of your Actual Budget server, for example http://localhost:5006
    • ACTUAL_BUDGET_ID Your budget's Sync ID, found under Settings > Show advanced settings

    説明は英語の原文のままです。

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

    SettingsDeveloperEdit Config

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

    {
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_SESSION_TOKEN": "your-value",
        "ACTUAL_BUDGET_ID": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORD": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORDS": "your-value",
        "ACTUAL_HTTP_TOKEN": "your-value",
        "ACTUAL_HTTP_WRITE_TOKEN": "your-value"
      }
    }
  }
}

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

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

  7. 試してみる

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

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

追加の設定 13 項目（入力しなくても使えます）

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

  • ACTUAL_PASSWORD Actual Budget サーバーのパスワード。ACTUAL_SESSION_TOKEN を設定している場合は不要です。
    英語の原文を見るPassword for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN
  • ACTUAL_BUDGET_IDS このサーバーが提供するすべての予算を、複数ある場合はカンマ区切りで指定します。各ツールは budget_id を受け取り、各予算は独自のプロセスで開かれます。
    英語の原文を見るEvery budget this server serves, comma separated, when it is more than one. Each tool then takes a budget_id, and each budget is opened in a process of its own
  • ACTUAL_BUDGET_WORKERS 同時に開いておく予算の数。デフォルトは 3 です。4 つ目の予算が開かれると、最も長く呼び出されていないものが閉じられます。
    英語の原文を見るHow many budgets stay open at once. Defaults to 3. A fourth budget closes the one that went longest without a call
  • ACTUAL_WORKER_IDLE_MINUTES 未処理の作業がないまま開いた予算が開いた状態を保つ時間。既定値は 15 です。
    英語の原文を見るHow long an open budget with nothing to do stays open. Defaults to 15
  • ACTUAL_WORKER_READY_SECONDS まだ開いている途中の予算を呼び出しが待つ時間。その後、まだ開いている途中であると応答します。既定値は 45 です。
    英語の原文を見るHow long a call waits for a budget that is still opening before it answers that it is still opening. Defaults to 45
  • ACTUAL_READ_ONLY 1 に設定すると、すべての書き込みツールをモデルから隠し、読み取りと分析のツールのみを公開します。
    英語の原文を見るSet to 1 to hide every write tool from the model, exposing only reads and analysis
  • ACTUAL_TOOLSET chat に設定すると、44 個すべてではなく 18 個の一般的なツールを提供します。これにより、接続ごとのツール説明は 39.7 KiB ではなく 17.4 KiB になります。既定値は full です。
    英語の原文を見るSet to chat to offer the 18 everyday tools instead of all 44, which is 17.4 KiB of tool descriptions instead of 39.7 KiB on every connection. Defaults to full
  • ACTUAL_DATA_DIR ローカル予算キャッシュ用のディレクトリ
    英語の原文を見るDirectory for the local budget cache
  • ACTUAL_HTTP_TIMEOUT_MS サーバーが応答を開始するまで待つ時間（ミリ秒）。既定値は 60000 です。GoCardless の銀行同期が途中で切断される場合は、この値を大きくしてください。
    英語の原文を見るHow long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off
  • ACTUAL_HTTP_PORT stdio の代わりにこのポートで HTTP 経由の MCP を提供します。自分で実行し、クライアントをそこに向けるサーバーでのみ使用してください。このパッケージを自分で起動するクライアントは stdio を使用するため、これを設定すると接続できなくなります。
    英語の原文を見るServe MCP over HTTP on this port instead of stdio. Only for a server you run yourself and point clients at: a client that starts this package itself speaks stdio and cannot reach it once this is set
  • ACTUAL_HTTP_HOST バインドするアドレス。既定値は 127.0.0.1 ですが、コンテナ内からは到達できないため、0.0.0.0 を ACTUAL_HTTP_ALLOW_REMOTE と併用します。
    英語の原文を見るWhat to bind to. Defaults to 127.0.0.1; inside a container that is unreachable, so 0.0.0.0 together with ACTUAL_HTTP_ALLOW_REMOTE
  • ACTUAL_HTTP_ALLOW_REMOTE 1 に設定すると、ループバック以外のアドレスにバインドします。ここでは TLS を終端しないため、前段に TLS を処理するものを配置してください。
    英語の原文を見るSet to 1 to bind somewhere other than loopback. Nothing here terminates TLS, so put something in front of it that does
  • ACTUAL_HTTP_ALLOWED_HOSTS Host ヘッダーで受け入れるホスト名（カンマ区切り、ポートなし）。loopback 以外にあるサーバー向けです。それ以外は 403 で応答されます。
    英語の原文を見るHostnames to accept in the Host header, comma separated and without ports, for a server that is not on loopback. Anything else is answered 403

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

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

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

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

代わりにできること

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

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

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

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

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

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

  1. Node.js を入れる

    1 回だけ。Node.js が必要なすべてのサーバーで使えます

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

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

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

    Actual Budget のサイトを開く ↗

  3. 設定を 2 項目入力

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

    • ACTUAL_SERVER_URL URL of your Actual Budget server, for example http://localhost:5006
    • ACTUAL_BUDGET_ID Your budget's Sync ID, found under Settings > Show advanced settings

    説明は英語の原文のままです。

  4. ターミナルを開く

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

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

    claude mcp add --scope user actual-budget --env ACTUAL_SERVER_URL=your-value --env ACTUAL_SESSION_TOKEN=your-value --env ACTUAL_BUDGET_ID=your-value --env ACTUAL_ENCRYPTION_PASSWORD=your-value --env ACTUAL_ENCRYPTION_PASSWORDS=your-value --env ACTUAL_HTTP_TOKEN=your-value --env ACTUAL_HTTP_WRITE_TOKEN=your-value -- npx -y actual-budget-mcp

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

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

  6. Claude Code で /mcp と入力

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

  7. 試してみる

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

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

追加の設定 13 項目（入力しなくても使えます）

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

  • ACTUAL_PASSWORD Actual Budget サーバーのパスワード。ACTUAL_SESSION_TOKEN を設定している場合は不要です。
    英語の原文を見るPassword for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN
  • ACTUAL_BUDGET_IDS このサーバーが提供するすべての予算を、複数ある場合はカンマ区切りで指定します。各ツールは budget_id を受け取り、各予算は独自のプロセスで開かれます。
    英語の原文を見るEvery budget this server serves, comma separated, when it is more than one. Each tool then takes a budget_id, and each budget is opened in a process of its own
  • ACTUAL_BUDGET_WORKERS 同時に開いておく予算の数。デフォルトは 3 です。4 つ目の予算が開かれると、最も長く呼び出されていないものが閉じられます。
    英語の原文を見るHow many budgets stay open at once. Defaults to 3. A fourth budget closes the one that went longest without a call
  • ACTUAL_WORKER_IDLE_MINUTES 未処理の作業がないまま開いた予算が開いた状態を保つ時間。既定値は 15 です。
    英語の原文を見るHow long an open budget with nothing to do stays open. Defaults to 15
  • ACTUAL_WORKER_READY_SECONDS まだ開いている途中の予算を呼び出しが待つ時間。その後、まだ開いている途中であると応答します。既定値は 45 です。
    英語の原文を見るHow long a call waits for a budget that is still opening before it answers that it is still opening. Defaults to 45
  • ACTUAL_READ_ONLY 1 に設定すると、すべての書き込みツールをモデルから隠し、読み取りと分析のツールのみを公開します。
    英語の原文を見るSet to 1 to hide every write tool from the model, exposing only reads and analysis
  • ACTUAL_TOOLSET chat に設定すると、44 個すべてではなく 18 個の一般的なツールを提供します。これにより、接続ごとのツール説明は 39.7 KiB ではなく 17.4 KiB になります。既定値は full です。
    英語の原文を見るSet to chat to offer the 18 everyday tools instead of all 44, which is 17.4 KiB of tool descriptions instead of 39.7 KiB on every connection. Defaults to full
  • ACTUAL_DATA_DIR ローカル予算キャッシュ用のディレクトリ
    英語の原文を見るDirectory for the local budget cache
  • ACTUAL_HTTP_TIMEOUT_MS サーバーが応答を開始するまで待つ時間（ミリ秒）。既定値は 60000 です。GoCardless の銀行同期が途中で切断される場合は、この値を大きくしてください。
    英語の原文を見るHow long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off
  • ACTUAL_HTTP_PORT stdio の代わりにこのポートで HTTP 経由の MCP を提供します。自分で実行し、クライアントをそこに向けるサーバーでのみ使用してください。このパッケージを自分で起動するクライアントは stdio を使用するため、これを設定すると接続できなくなります。
    英語の原文を見るServe MCP over HTTP on this port instead of stdio. Only for a server you run yourself and point clients at: a client that starts this package itself speaks stdio and cannot reach it once this is set
  • ACTUAL_HTTP_HOST バインドするアドレス。既定値は 127.0.0.1 ですが、コンテナ内からは到達できないため、0.0.0.0 を ACTUAL_HTTP_ALLOW_REMOTE と併用します。
    英語の原文を見るWhat to bind to. Defaults to 127.0.0.1; inside a container that is unreachable, so 0.0.0.0 together with ACTUAL_HTTP_ALLOW_REMOTE
  • ACTUAL_HTTP_ALLOW_REMOTE 1 に設定すると、ループバック以外のアドレスにバインドします。ここでは TLS を終端しないため、前段に TLS を処理するものを配置してください。
    英語の原文を見るSet to 1 to bind somewhere other than loopback. Nothing here terminates TLS, so put something in front of it that does
  • ACTUAL_HTTP_ALLOWED_HOSTS Host ヘッダーで受け入れるホスト名（カンマ区切り、ポートなし）。loopback 以外にあるサーバー向けです。それ以外は 403 で応答されます。
    英語の原文を見るHostnames to accept in the Host header, comma separated and without ports, for a server that is not on loopback. Anything else is answered 403

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

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

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

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

  1. Node.js を入れる

    1 回だけ。Node.js が必要なすべてのサーバーで使えます

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

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

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

    Actual Budget のサイトを開く ↗

  3. 設定を 2 項目入力

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

    • ACTUAL_SERVER_URL URL of your Actual Budget server, for example http://localhost:5006
    • ACTUAL_BUDGET_ID Your budget's Sync ID, found under Settings > Show advanced settings

    説明は英語の原文のままです。

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

    Cursor で開く

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

  5. キーを入力

    Actual Budget の設定で ACTUAL_SESSION_TOKEN, ACTUAL_ENCRYPTION_PASSWORD, ACTUAL_ENCRYPTION_PASSWORDS, ACTUAL_HTTP_TOKEN, ACTUAL_HTTP_WRITE_TOKEN, ACTUAL_SERVER_URL, ACTUAL_BUDGET_ID が空です。自分のキーを入れて保存します

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

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

  7. 試してみる

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

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

追加の設定 13 項目（入力しなくても使えます）

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

  • ACTUAL_PASSWORD Actual Budget サーバーのパスワード。ACTUAL_SESSION_TOKEN を設定している場合は不要です。
    英語の原文を見るPassword for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN
  • ACTUAL_BUDGET_IDS このサーバーが提供するすべての予算を、複数ある場合はカンマ区切りで指定します。各ツールは budget_id を受け取り、各予算は独自のプロセスで開かれます。
    英語の原文を見るEvery budget this server serves, comma separated, when it is more than one. Each tool then takes a budget_id, and each budget is opened in a process of its own
  • ACTUAL_BUDGET_WORKERS 同時に開いておく予算の数。デフォルトは 3 です。4 つ目の予算が開かれると、最も長く呼び出されていないものが閉じられます。
    英語の原文を見るHow many budgets stay open at once. Defaults to 3. A fourth budget closes the one that went longest without a call
  • ACTUAL_WORKER_IDLE_MINUTES 未処理の作業がないまま開いた予算が開いた状態を保つ時間。既定値は 15 です。
    英語の原文を見るHow long an open budget with nothing to do stays open. Defaults to 15
  • ACTUAL_WORKER_READY_SECONDS まだ開いている途中の予算を呼び出しが待つ時間。その後、まだ開いている途中であると応答します。既定値は 45 です。
    英語の原文を見るHow long a call waits for a budget that is still opening before it answers that it is still opening. Defaults to 45
  • ACTUAL_READ_ONLY 1 に設定すると、すべての書き込みツールをモデルから隠し、読み取りと分析のツールのみを公開します。
    英語の原文を見るSet to 1 to hide every write tool from the model, exposing only reads and analysis
  • ACTUAL_TOOLSET chat に設定すると、44 個すべてではなく 18 個の一般的なツールを提供します。これにより、接続ごとのツール説明は 39.7 KiB ではなく 17.4 KiB になります。既定値は full です。
    英語の原文を見るSet to chat to offer the 18 everyday tools instead of all 44, which is 17.4 KiB of tool descriptions instead of 39.7 KiB on every connection. Defaults to full
  • ACTUAL_DATA_DIR ローカル予算キャッシュ用のディレクトリ
    英語の原文を見るDirectory for the local budget cache
  • ACTUAL_HTTP_TIMEOUT_MS サーバーが応答を開始するまで待つ時間（ミリ秒）。既定値は 60000 です。GoCardless の銀行同期が途中で切断される場合は、この値を大きくしてください。
    英語の原文を見るHow long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off
  • ACTUAL_HTTP_PORT stdio の代わりにこのポートで HTTP 経由の MCP を提供します。自分で実行し、クライアントをそこに向けるサーバーでのみ使用してください。このパッケージを自分で起動するクライアントは stdio を使用するため、これを設定すると接続できなくなります。
    英語の原文を見るServe MCP over HTTP on this port instead of stdio. Only for a server you run yourself and point clients at: a client that starts this package itself speaks stdio and cannot reach it once this is set
  • ACTUAL_HTTP_HOST バインドするアドレス。既定値は 127.0.0.1 ですが、コンテナ内からは到達できないため、0.0.0.0 を ACTUAL_HTTP_ALLOW_REMOTE と併用します。
    英語の原文を見るWhat to bind to. Defaults to 127.0.0.1; inside a container that is unreachable, so 0.0.0.0 together with ACTUAL_HTTP_ALLOW_REMOTE
  • ACTUAL_HTTP_ALLOW_REMOTE 1 に設定すると、ループバック以外のアドレスにバインドします。ここでは TLS を終端しないため、前段に TLS を処理するものを配置してください。
    英語の原文を見るSet to 1 to bind somewhere other than loopback. Nothing here terminates TLS, so put something in front of it that does
  • ACTUAL_HTTP_ALLOWED_HOSTS Host ヘッダーで受け入れるホスト名（カンマ区切り、ポートなし）。loopback 以外にあるサーバー向けです。それ以外は 403 で応答されます。
    英語の原文を見るHostnames to accept in the Host header, comma separated and without ports, for a server that is not on loopback. Anything else is answered 403

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

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

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

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

  1. Node.js を入れる

    1 回だけ。Node.js が必要なすべてのサーバーで使えます

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

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

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

    Actual Budget のサイトを開く ↗

  3. 設定を 2 項目入力

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

    • ACTUAL_SERVER_URL URL of your Actual Budget server, for example http://localhost:5006
    • ACTUAL_BUDGET_ID Your budget's Sync ID, found under Settings > Show advanced settings

    説明は英語の原文のままです。

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

    VS Code で開く

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

  5. キーを入力

    Actual Budget の設定で ACTUAL_SESSION_TOKEN, ACTUAL_ENCRYPTION_PASSWORD, ACTUAL_ENCRYPTION_PASSWORDS, ACTUAL_HTTP_TOKEN, ACTUAL_HTTP_WRITE_TOKEN, ACTUAL_SERVER_URL, ACTUAL_BUDGET_ID が空です。自分のキーを入れて保存します

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

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

  7. 試してみる

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

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

追加の設定 13 項目（入力しなくても使えます）

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

  • ACTUAL_PASSWORD Actual Budget サーバーのパスワード。ACTUAL_SESSION_TOKEN を設定している場合は不要です。
    英語の原文を見るPassword for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN
  • ACTUAL_BUDGET_IDS このサーバーが提供するすべての予算を、複数ある場合はカンマ区切りで指定します。各ツールは budget_id を受け取り、各予算は独自のプロセスで開かれます。
    英語の原文を見るEvery budget this server serves, comma separated, when it is more than one. Each tool then takes a budget_id, and each budget is opened in a process of its own
  • ACTUAL_BUDGET_WORKERS 同時に開いておく予算の数。デフォルトは 3 です。4 つ目の予算が開かれると、最も長く呼び出されていないものが閉じられます。
    英語の原文を見るHow many budgets stay open at once. Defaults to 3. A fourth budget closes the one that went longest without a call
  • ACTUAL_WORKER_IDLE_MINUTES 未処理の作業がないまま開いた予算が開いた状態を保つ時間。既定値は 15 です。
    英語の原文を見るHow long an open budget with nothing to do stays open. Defaults to 15
  • ACTUAL_WORKER_READY_SECONDS まだ開いている途中の予算を呼び出しが待つ時間。その後、まだ開いている途中であると応答します。既定値は 45 です。
    英語の原文を見るHow long a call waits for a budget that is still opening before it answers that it is still opening. Defaults to 45
  • ACTUAL_READ_ONLY 1 に設定すると、すべての書き込みツールをモデルから隠し、読み取りと分析のツールのみを公開します。
    英語の原文を見るSet to 1 to hide every write tool from the model, exposing only reads and analysis
  • ACTUAL_TOOLSET chat に設定すると、44 個すべてではなく 18 個の一般的なツールを提供します。これにより、接続ごとのツール説明は 39.7 KiB ではなく 17.4 KiB になります。既定値は full です。
    英語の原文を見るSet to chat to offer the 18 everyday tools instead of all 44, which is 17.4 KiB of tool descriptions instead of 39.7 KiB on every connection. Defaults to full
  • ACTUAL_DATA_DIR ローカル予算キャッシュ用のディレクトリ
    英語の原文を見るDirectory for the local budget cache
  • ACTUAL_HTTP_TIMEOUT_MS サーバーが応答を開始するまで待つ時間（ミリ秒）。既定値は 60000 です。GoCardless の銀行同期が途中で切断される場合は、この値を大きくしてください。
    英語の原文を見るHow long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off
  • ACTUAL_HTTP_PORT stdio の代わりにこのポートで HTTP 経由の MCP を提供します。自分で実行し、クライアントをそこに向けるサーバーでのみ使用してください。このパッケージを自分で起動するクライアントは stdio を使用するため、これを設定すると接続できなくなります。
    英語の原文を見るServe MCP over HTTP on this port instead of stdio. Only for a server you run yourself and point clients at: a client that starts this package itself speaks stdio and cannot reach it once this is set
  • ACTUAL_HTTP_HOST バインドするアドレス。既定値は 127.0.0.1 ですが、コンテナ内からは到達できないため、0.0.0.0 を ACTUAL_HTTP_ALLOW_REMOTE と併用します。
    英語の原文を見るWhat to bind to. Defaults to 127.0.0.1; inside a container that is unreachable, so 0.0.0.0 together with ACTUAL_HTTP_ALLOW_REMOTE
  • ACTUAL_HTTP_ALLOW_REMOTE 1 に設定すると、ループバック以外のアドレスにバインドします。ここでは TLS を終端しないため、前段に TLS を処理するものを配置してください。
    英語の原文を見るSet to 1 to bind somewhere other than loopback. Nothing here terminates TLS, so put something in front of it that does
  • ACTUAL_HTTP_ALLOWED_HOSTS Host ヘッダーで受け入れるホスト名（カンマ区切り、ポートなし）。loopback 以外にあるサーバー向けです。それ以外は 403 で応答されます。
    英語の原文を見るHostnames to accept in the Host header, comma separated and without ports, for a server that is not on loopback. Anything else is answered 403

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

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

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

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

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

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

パソコンにインストール

Claude Code

claude mcp add --scope user actual-budget --env ACTUAL_SERVER_URL=your-value --env ACTUAL_SESSION_TOKEN=your-value --env ACTUAL_BUDGET_ID=your-value --env ACTUAL_ENCRYPTION_PASSWORD=your-value --env ACTUAL_ENCRYPTION_PASSWORDS=your-value --env ACTUAL_HTTP_TOKEN=your-value --env ACTUAL_HTTP_WRITE_TOKEN=your-value -- npx -y actual-budget-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_SESSION_TOKEN": "your-value",
        "ACTUAL_BUDGET_ID": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORD": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORDS": "your-value",
        "ACTUAL_HTTP_TOKEN": "your-value",
        "ACTUAL_HTTP_WRITE_TOKEN": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_SESSION_TOKEN": "your-value",
        "ACTUAL_BUDGET_ID": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORD": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORDS": "your-value",
        "ACTUAL_HTTP_TOKEN": "your-value",
        "ACTUAL_HTTP_WRITE_TOKEN": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "actual-budget": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "actual-budget-mcp"
      ],
      "env": {
        "ACTUAL_SERVER_URL": "your-value",
        "ACTUAL_SESSION_TOKEN": "your-value",
        "ACTUAL_BUDGET_ID": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORD": "your-value",
        "ACTUAL_ENCRYPTION_PASSWORDS": "your-value",
        "ACTUAL_HTTP_TOKEN": "your-value",
        "ACTUAL_HTTP_WRITE_TOKEN": "your-value"
      }
    }
  }
}

自分で入力する値

  • ACTUAL_SERVER_URL 必須 env
    URL of your Actual Budget server, for example http://localhost:5006
  • ACTUAL_PASSWORD 秘密 env
    Actual Budget サーバーのパスワード。ACTUAL_SESSION_TOKEN を設定している場合は不要です。
    英語の原文を見るPassword for your Actual Budget server. Not needed if you set ACTUAL_SESSION_TOKEN
  • ACTUAL_SESSION_TOKEN 秘密 必須 env
    パスワードを持たない OIDC 配下のサーバー用のセッショントークン。ACTUAL_PASSWORD の代わりに使用します。両方が設定されている場合はトークンが優先されます。
    英語の原文を見るSession token for servers behind OIDC, which have no password. Use instead of ACTUAL_PASSWORD; if both are set, the token wins
  • ACTUAL_BUDGET_ID 必須 env
    Your budget's Sync ID, found under Settings > Show advanced settings
  • ACTUAL_ENCRYPTION_PASSWORD 秘密 必須 env
    予算ファイルがエンドツーエンドで暗号化されている場合にのみ必要です
    英語の原文を見るOnly needed if your budget file is end-to-end encrypted
  • ACTUAL_BUDGET_IDS env
    このサーバーが提供するすべての予算を、複数ある場合はカンマ区切りで指定します。各ツールは budget_id を受け取り、各予算は独自のプロセスで開かれます。
    英語の原文を見るEvery budget this server serves, comma separated, when it is more than one. Each tool then takes a budget_id, and each budget is opened in a process of its own
  • ACTUAL_ENCRYPTION_PASSWORDS 秘密 必須 env
    budget sync ID から暗号化パスワードへの対応を表す JSON オブジェクト。複数の予算が暗号化されている場合に使用します。各ワーカーには自分の分だけが渡され、マップ全体は渡されません。
    英語の原文を見るA JSON object of budget sync id to encryption password, for when more than one of the budgets is encrypted. Each worker is given its own and never the map
  • ACTUAL_BUDGET_WORKERS env
    同時に開いておく予算の数。デフォルトは 3 です。4 つ目の予算が開かれると、最も長く呼び出されていないものが閉じられます。
    英語の原文を見るHow many budgets stay open at once. Defaults to 3. A fourth budget closes the one that went longest without a call
  • ACTUAL_WORKER_IDLE_MINUTES env
    未処理の作業がないまま開いた予算が開いた状態を保つ時間。既定値は 15 です。
    英語の原文を見るHow long an open budget with nothing to do stays open. Defaults to 15
  • ACTUAL_WORKER_READY_SECONDS env
    まだ開いている途中の予算を呼び出しが待つ時間。その後、まだ開いている途中であると応答します。既定値は 45 です。
    英語の原文を見るHow long a call waits for a budget that is still opening before it answers that it is still opening. Defaults to 45
  • ACTUAL_READ_ONLY env
    1 に設定すると、すべての書き込みツールをモデルから隠し、読み取りと分析のツールのみを公開します。
    英語の原文を見るSet to 1 to hide every write tool from the model, exposing only reads and analysis
  • ACTUAL_TOOLSET env
    chat に設定すると、44 個すべてではなく 18 個の一般的なツールを提供します。これにより、接続ごとのツール説明は 39.7 KiB ではなく 17.4 KiB になります。既定値は full です。
    英語の原文を見るSet to chat to offer the 18 everyday tools instead of all 44, which is 17.4 KiB of tool descriptions instead of 39.7 KiB on every connection. Defaults to full
  • ACTUAL_DATA_DIR env
    ローカル予算キャッシュ用のディレクトリ
    英語の原文を見るDirectory for the local budget cache
  • ACTUAL_HTTP_TIMEOUT_MS env
    サーバーが応答を開始するまで待つ時間（ミリ秒）。既定値は 60000 です。GoCardless の銀行同期が途中で切断される場合は、この値を大きくしてください。
    英語の原文を見るHow long to wait for your server to start replying, in milliseconds. Defaults to 60000; raise it if a GoCardless bank sync is being cut off
  • ACTUAL_HTTP_PORT env
    stdio の代わりにこのポートで HTTP 経由の MCP を提供します。自分で実行し、クライアントをそこに向けるサーバーでのみ使用してください。このパッケージを自分で起動するクライアントは stdio を使用するため、これを設定すると接続できなくなります。
    英語の原文を見るServe MCP over HTTP on this port instead of stdio. Only for a server you run yourself and point clients at: a client that starts this package itself speaks stdio and cannot reach it once this is set
  • ACTUAL_HTTP_TOKEN 秘密 必須 env
    読み取りパス /mcp の認証情報です。ACTUAL_HTTP_PORT を設定すると必須になり、32 文字以上である必要があります。
    英語の原文を見るThe credential for the read path, /mcp. Required once ACTUAL_HTTP_PORT is set, and at least 32 characters
  • ACTUAL_HTTP_WRITE_TOKEN 秘密 必須 env
    書き込みパス /mcp-write 用の 2 つ目の認証情報。これがない場合、サーバーは書き込みパスを一切提供しません。
    英語の原文を見るA second credential, for the write path, /mcp-write. Without it the server serves no write path at all
  • ACTUAL_HTTP_HOST env
    バインドするアドレス。既定値は 127.0.0.1 ですが、コンテナ内からは到達できないため、0.0.0.0 を ACTUAL_HTTP_ALLOW_REMOTE と併用します。
    英語の原文を見るWhat to bind to. Defaults to 127.0.0.1; inside a container that is unreachable, so 0.0.0.0 together with ACTUAL_HTTP_ALLOW_REMOTE
  • ACTUAL_HTTP_ALLOW_REMOTE env
    1 に設定すると、ループバック以外のアドレスにバインドします。ここでは TLS を終端しないため、前段に TLS を処理するものを配置してください。
    英語の原文を見るSet to 1 to bind somewhere other than loopback. Nothing here terminates TLS, so put something in front of it that does
  • ACTUAL_HTTP_ALLOWED_HOSTS env
    Host ヘッダーで受け入れるホスト名（カンマ区切り、ポートなし）。loopback 以外にあるサーバー向けです。それ以外は 403 で応答されます。
    英語の原文を見るHostnames to accept in the Host header, comma separated and without ports, for a server that is not on loopback. Anything else is answered 403

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

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

ひと目でわかる

週あたりのダウンロードi
546/週
接続方法
パソコンで動く
最新バージョンi
0.12.0
レジストリ公開日i
2026年11月4日
コードの最終更新i
2026年11月11日
作者
henfrydls
パッケージ
npm: actual-budget-mcp
oci: ghcr.io/henfrydls/actual-budget-mcp:0.12.0
ウェブサイト
actual-mcp.henfrydls.com
レジストリでの状態
有効

使えるアプリ

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

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

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

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

できること

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

基本チェックi

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

  • ✓ 合格

    作者とリポジトリが一致

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

  • ✓ 合格

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

    コードの最終更新：3 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

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

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

  • – 対象外

    OAuthでサインイン

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

  • … 未チェック

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

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

話し合い

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

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

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

Google でログインして投稿

ユーザーレビュー

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

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

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

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

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

よくある質問

Actual Budgetは安全ですか？

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

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

入力が必要なもの：ACTUAL_SESSION_TOKEN, ACTUAL_ENCRYPTION_PASSWORD, ACTUAL_ENCRYPTION_PASSWORDS, ACTUAL_HTTP_TOKEN, ACTUAL_HTTP_WRITE_TOKEN

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

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

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

GitHubリポジトリの最終更新は3 日前、最新バージョン（0.12.0）がレジストリに届いたのは10 日前です。

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

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

代わりに使えるものは？

同じカテゴリには：CCXT, Finance Toolkit, AKQuant

同じカテゴリのほかの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

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

CCXT

Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets

作者：ccxt広く使われている↓ 667/週★ 4.5万 リポジトリ全体のスター2 か月前更新

パソコンで動く
インストール

Finance Toolkit

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

作者：JerBouma広く使われている↓ 1.6万/週★ 55235 日前更新

パソコンでもクラウドでも
インストール

AKQuant

Write and backtest trading strategies with AKQuant: API lookup, strategy checks, backtest runs

作者：akfamily広く使われている↓ 3280/週★ 2604今日更新

パソコンで動く
インストール

作者のREADME

READMEを開く

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

actual-budget-mcp

Talk to your budget. An MCP server that connects Actual Budget to Claude. Ask where the money went, get real analysis back, and let it write without holding your breath.

Listed in the official Actual Budget community projects.

Features

  • Real analysis, not just lookups - Projections, category trends, budget vs actual, and month summaries
  • Writes you can trust - Every delete previews what it will remove and waits for you to confirm; ACTUAL_READ_ONLY=1 hides the write tools from the model entirely (Safety)
  • Multi-currency that survives reality - Splits and residual reconciliation, not just a currency symbol
  • Recovers from an out-of-sync budget - repair_sync rebuilds the local sync state when @actual-app/api and your server disagree, the failure that otherwise leaves every tool erroring
  • Ask about your budget in plain language - "How much did I spend on food this month?" or "Am I over budget on anything?"
  • Create and manage transactions - Add expenses, transfers, and edits without opening the app
  • Manage categories, payees, and rules - Full CRUD without opening the app
  • Use names, not IDs - Say "Wallet" instead of a1b2c3d4-..., with helpful suggestions if ambiguous
  • Natural dates in English and Spanish - "last month", "este mes", "hace 3 meses", "yesterday"
  • Clean formatted output - Aligned tables and clear summaries, not raw JSON
  • Clear error messages - If something's wrong, you'll know exactly what to fix

Does it work with local models?

Yes. This is an MCP server, so it works with any client that speaks MCP, and the model behind that client is the client's business, not this server's. Claude Desktop, Claude Code, Cursor and VS Code are the ones documented below because they are the ones people ask about, but anything that can run an MCP client, including a local setup pointed at Ollama or LM Studio, talks to it the same way.

Your budget data goes to whatever model your client uses. If that matters to you, and for a lot of people running Actual it does, a local model keeps it on your machine.

Does it work with ChatGPT?

No. ChatGPT's connectors only accept remote MCP servers: a public HTTPS endpoint speaking SSE or Streamable HTTP. With HTTP mode this server can be one. What we have read says their connectors sign in through OAuth or not at all and cannot send the fixed token header this version takes, and nobody here has tried it. OpenAI does offer a tunnel for local servers, but it is limited to enterprise plans.

Making it work would mean exposing your Actual server to the internet, which is the opposite of what most people running Actual want. Anything that can start a local MCP process works instead: Claude Desktop, Claude Code, Cursor, VS Code, Gemini CLI, or your own setup pointed at a local model.

If what you actually want is OpenAI's model, use Codex, which does run MCP servers locally over stdio. Option 6 is the one command it takes.

Prerequisites

  • Actual Budget server running (local or remote)
  • Node.js 22.14 or newer for every option below except the Desktop Extension (see Node.js requirement)
  • The Desktop Extension needs nothing but Claude Desktop. It runs on the Node that Claude Desktop ships, and the bundle carries a SQLite binary for every platform it supports, so nothing is compiled either. Checked on Windows 11 with Claude Desktop 2.110.0 and Node removed from the machine.

Quick Start

On Claude Desktop, the shortest path is the extension: no config file to edit and no command to run. Otherwise, copy this into Claude Code or Claude Desktop:

Install the actual-budget-mcp MCP server from npm (https://github.com/henfrydls/actual-budget-mcp).

Configure it with these credentials:

  • My Actual Budget server: http://localhost:5006
  • Password: YOUR_PASSWORD
  • Budget ID: YOUR_BUDGET_ID

Claude will configure everything for you.

Installation

Option 1: Claude Desktop extension (no config files)

A packaged Desktop Extension is available: install it and Claude Desktop asks for your server URL, password and Sync ID in its own settings UI, with the password and session token stored in your operating system's keychain rather than a config file you have to edit.

[Download actual-budget-mcp.mcpb](https://github.com/henfrydls/actual-budget-mcp/releases/latest/download/actual-budget-mcp.mcpb), then open Claude Desktop, go to Settings > Extensions, and drag the file onto that screen.

On Windows, dragging is the way in: double-clicking the file opens Windows' "select an app to open this file" dialogue instead, because Claude Desktop does not register the .mcpb file type. Verified on a clean Windows 11 install with Claude Desktop 0.14.10.

The extension carries everything it needs, so the first question you ask is answered straight away rather than after an install you cannot see. It is a large download, once, with a progress bar.

You do not need Node.js installed for this route. Claude Desktop runs the extension on the Node it ships with. Checked by renaming Node out of the way on a Windows 11 machine and asking a question anyway: the server started and answered.

Earlier builds launched the package from npm instead. That made the download small and moved it to the first run, where nothing showed progress: Claude Desktop waited, decided the server was dead and said it could not connect, and the extension started working on its own a few minutes later. The bundle now includes Actual's SQLite binary for every platform it supports. They are N-API binaries, so one per platform serves every Node version, and nothing has to be chosen at startup.

Updating the extension

Installing a new version over an old one keeps the settings you filled in, with one exception seen in practice: the saved server password was cleared when a field's title changed between versions. If Claude cannot connect after an update, open the extension's settings and check the password field before looking anywhere else.

Option 2: Claude Code (one command)
claude mcp add actual-budget-mcp -e ACTUAL_SERVER_URL=http://localhost:5006 -e ACTUAL_PASSWORD=your-password -e ACTUAL_BUDGET_ID=your-budget-id -- npx -y actual-budget-mcp
Option 3: Claude Desktop (edit the config file)

Add this to your claude_desktop_config.json:

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

{

"mcpServers": { "actual-budget-mcp": { "command": "npx", "args": ["-y", "actual-budget-mcp"], "env": { "ACTUAL_SERVER_URL": "http://localhost:5006", "ACTUAL_PASSWORD": "your-password", "ACTUAL_BUDGET_ID": "your-budget-sync-id" } } } }

Option 4: Cursor

The button installs it with placeholder values. Open Cursor Settings > MCP afterwards and replace the three: your server URL, your password, and your budget's Sync ID. To do it all by hand instead, go to Cursor Settings > MCP > Add new MCP server and add:

{

"mcpServers": { "actual-budget-mcp": { "command": "npx", "args": ["-y", "actual-budget-mcp"], "env": { "ACTUAL_SERVER_URL": "http://localhost:5006", "ACTUAL_PASSWORD": "your-password", "ACTUAL_BUDGET_ID": "your-budget-sync-id" } } } }

Option 5: VS Code (GitHub Copilot)

Same as above: the button fills in placeholders, and you replace the three values afterwards. By hand, add this to your VS Code settings.json:

{

"mcp": { "servers": { "actual-budget-mcp": { "command": "npx", "args": ["-y", "actual-budget-mcp"], "env": { "ACTUAL_SERVER_URL": "http://localhost:5006", "ACTUAL_PASSWORD": "your-password", "ACTUAL_BUDGET_ID": "your-budget-sync-id" } } } } }

Option 6: Codex (OpenAI)

One command, and it writes the entry into ~/.codex/config.toml for you:

codex mcp add actual-budget-mcp \

--env ACTUAL_SERVER_URL=http://localhost:5006 \ --env ACTUAL_PASSWORD=your-password \ --env ACTUAL_BUDGET_ID=your-budget-sync-id \ -- npx -y actual-budget-mcp

Codex has no extension or bundle format, so this one-liner is the shortest route there is. codex mcp list shows it afterwards, and codex mcp remove actual-budget-mcp undoes it.

This is Codex the local agent, the CLI and the IDE extension. Codex in the browser runs on OpenAI's machines and cannot reach an Actual server on your network.

Option 7: Docker

The image speaks stdio like every other option, so your client starts the container and owns its lifetime:

{

"mcpServers": { "actual-budget-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "--add-host=host.docker.internal:host-gateway", "-v", "actual-budget-mcp-data:/data", "-e", "ACTUAL_SERVER_URL", "-e", "ACTUAL_PASSWORD", "-e", "ACTUAL_BUDGET_ID", "ghcr.io/henfrydls/actual-budget-mcp:latest" ], "env": { "ACTUAL_SERVER_URL": "http://host.docker.internal:5006", "ACTUAL_PASSWORD": "your-password", "ACTUAL_BUDGET_ID": "your-budget-sync-id" } } } }

Two things that bite everyone once:

  • Inside the container, `localhost` is the container. Your Actual server is not there. host.docker.internal (

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