メインコンテンツへスキップ
見出し画像

【緊急解説】MoneyFowardクラウド会計APIの設定の仕方【チュートリアル】

    緊急です。MonyeFowardがクラウド会計のAPIをすべてのプランに対し解放したので、APIを使うための事前のセッティングを解説していきます。

    APIとは、Application Program Interfaceの略称であり、今回は、クラウド会計(Application)に作ったプログラム(Program)にアクセスさせ、サービスを利用するための入り口(Interface)となります。

    独自の連携を構築するには、APIの設定が必要になりますので、その設定手順を解説していきます。

    Step1:アプリ登録する

    以下のページの内容を解説しています。

    Step1では、APIを作成するための下準備として、APIを作成できる権限をユーザーに与えるための設定です。※組織でAPIを活用する場合、IT管理者が設定すべき内容です。

    まずはアプリポータルにアクセスし、APIを作成したい事業者を選びます。※freeeとは違い、同じAPIで複数の事業者にアクセスすることはできないので注意が必要です。

    アプリポータルはこちら
    https://app-portal.moneyforward.com/


    ログインし、事業者を選ぶと以下のような画面になると思います。

    画像

    まずは、ユーザー欄の自分の欄の権限を確認しましょう。

    画像

    自分の名前をクリックし、権限に「システム管理」と「アプリ開発」の両方がついていることを確認してください。これらの権限(及びその編集権限)がない場合、その事業所でAPIを設定することはできません。

    画像

    上記権限があることを確認したら、初期設定ではアプリ連携権限に"権限がありません"と出ると思うので、右上の青い「編集」ボタン又はその後の文章のリンクになっている「編集画面」という文字をクリックします。

    権限の編集画面を出しアプリ連携にチェックをいれるとMFの各サービス名が表示されるので、クラウド会計・確定申告をチェックし、右上の保存ボタンをクリックします。

    画像

    保存後、以下のような設定状況になっていればOKです!

    画像

    ここまでは先ほどのURLの公式サポートに載っている内容です。これ以降何したらいいかわからないとなっている人も多いと思われますので、

    Step2:APIを実際に構築していく

    以下のページの解説をしています。

    Step1でユーザー権限の設定が終わったため、次は実際にAPIを設定していきます。

    まずは、アプリ開発メニューを開きます。(APIキー管理メニューではないので注意)
    次に、右上の「新規登録」という青いボタン又は初めて登録する際は、画面中央に現れる「新規登録」のボタンを押してください。

    画像

    そうすると、APIになるアプリケーションの情報を登録する画面が表示されますので、そこに情報を入力します。

    画像

    入力する内容の詳細は下記のとおりです。すべて入力し終わったら右上の「登録」ボタンが青くなりますので、押して登録します。

    アプリ名称

    連携目的や用途ごとに分ける場合に複数のAPIを設定する可能性があるため、目的や用途に沿った管理しやすい任意の名称を設定してください。

    リダイレクトURI

    認証が終わった後にどの画面に戻るか設定することができます。
    特にWebサービスに組み込む等でない場合、localhostなどの入力値になります。

    GASからAPIにアクセスする場合
    以下のような値をリダイレクトURIに設定します。

    https://script.google.com/macros/d/【あなたのスクリプトID】/usercallback

    スクリプトIDはGoogleAppScriptのプロジェクト設定に値があります。

    画像
    ここに入力されている英数字です!と書いてある場所にIDが書いています。

    クライアント認証方式

    ここを意識することはほとんどないと思います。BASICが推奨されているので、BASICを選びましょう。

    利用規約の確認

    きちんと利用規約を読まないと同意するのチェックができないので、利用規約を読んでください。

    画像

    保存ボタンを押すと、下記のような画面が表示されると思いますので、その中のClient IDとClient SecretがプログラムからAPIにアクセスする際に、必要な情報になります。

    特にClientSecretはAPIのカギになりますので、絶対に他人に公開しないようにしましょう。

    画像
    ここまで出来たら、マネーフォワード側の設定は完了です。実際にコードを書いていきましょう。

    Step3:GASからAPIへのアクセスを認証しよう

    次は、APIにアクセスをするための認証を行いましょう。

    1.認証に関するコード (Auth.gs)を設定する

    GASエディタで「ファイル」>「+」>「スクリプト」から Auth.gs という名前でファイルを作成し、以下のコードを貼り付けます。

    コード上部のCLIENT_IDは先ほどのアプリの登録で発行されたIDに書き換えてください。

    また、今回は権限を勘定科目と補助科目の参照に絞っています。様々な機能を利用する際には、コメントアウトを外し、APIの権限を適切な構成にしましょう。

    freeeのAPIではアプリ設定側で権限を設定しますが、MFではコード上で権限を管理する形になる点に注意が必要です(アプリごとに中央集権的な権限管理はできない)

    2026/03/31追記:Basic認証用の仕様にする前のものを掲載していたため、Basic認証用の仕様に内容を差し替えています。
    Step2でアプリポータルでクライアントの認証方式をCLIENT_SECRET_BASICではなく、CLIENT_SECRET_POSTを選んでいる場合、
    // .setClientSecret(CLIENT_SECRET)
    の行のコメントアウト(// の記号)を外してください。両方のコメントを外していても動作しますが、念のためクライアント認証方式に合わせた形で記載することをお勧めします。

    // ==========================================
    // Auth.gs: 認証(OAuth2)に関する設定と処理
    // ==========================================
    
    // ------------------------------------------
    // ▼ 設定エリア(ここだけ変更すればOK!)
    // ------------------------------------------
    
    // 1. クライアントIDの設定
    // TODO: マネーフォワードで発行されたClient IDに書き換えてください。
    const CLIENT_ID = '**********************';
    
    // 2. 利用するAPIのスコープ(権限)設定
    // 必要な機能の先頭にある「//」を消す(コメントアウトを解除する)と有効になります。
    //
    // 【重要】スコープ(権限)のコメントアウトを変更した際の注意点
    // マネーフォワード側が古い権限を記憶しているため、設定を変更した後は
    // 取得済みの古いカギを破棄して「再認証」を行う必要があります。
    // 必ず以下の手順でもう一度関数を実行してください:
    //   1. 関数 resetAuth を実行する(古い認証情報をリセット)
    //   2. 関数 logRedirectUriAndAuthUrl を実行する
    //   3. ログに出たURLにブラウザでアクセスして、新しい権限で「許可」を出し直す
    const SCOPES_ARRAY = [
      // 'mfc/accounting/offices.read',           // 事業者情報の取得
      'mfc/accounting/accounts.read',             // 勘定科目の参照、補助科目の参照
      // 'mfc/accounting/departments.read',       // 部門の参照
      // 'mfc/accounting/journal.read',           // 仕訳の参照
      // 'mfc/accounting/journal.write',          // 仕訳の登録、更新、削除
      // 'mfc/accounting/voucher.write',          // 証憑の登録、削除
      // 'mfc/accounting/report.read',            // 帳票の参照
      // 'mfc/accounting/taxes.read',             // 税の参照
      // 'mfc/accounting/trade_partners.read',    // 取引先の参照
      // 'mfc/accounting/trade_partners.write',   // 取引先の登録
      // 'mfc/accounting/connected_account.read', // 連携サービスの参照
      // 'mfc/accounting/transaction.write'       // 明細の作成、更新
    ];
    
    // 有効にした配列をスペース区切りの文字列に結合
    const SCOPES_STRING = SCOPES_ARRAY.join(' ');
    
    // 3. スクリプトプロパティからClient Secretを取得
    const CLIENT_SECRET = PropertiesService.getScriptProperties().getProperty('CLIENT_SECRET');
    
    
    // ------------------------------------------
    // ▼ システム処理エリア(基本いじらなくてOK)
    // ------------------------------------------
    
    /**
     * OAuth2 認証サービスの設定
     */
    function getMoneyForwardService() {
      return OAuth2.createService('MoneyForward')
        .setAuthorizationBaseUrl('https://api.biz.moneyforward.com/authorize') 
        .setTokenUrl('https://api.biz.moneyforward.com/token') 
        .setClientId(CLIENT_ID)
        // ▼ アプリポータルでクライアント認証方式をCLIENT_SECRET_POSTにしている場合に有効にする
        // .setClientSecret(CLIENT_SECRET)
        .setCallbackFunction('authCallback')
        .setPropertyStore(PropertiesService.getUserProperties())
        .setScope(SCOPES_STRING)
        // ▼ Basic認証用のヘッダー(アプリポータルでクライアント認証方式をCLIENT_SECRET_BASICにしている場合に有効にする)
        .setTokenHeaders({
          'Authorization': 'Basic ' + Utilities.base64Encode(CLIENT_ID + ':' + CLIENT_SECRET)
        });
    }
    
    /**
     * 認証用URLとリダイレクトURIを出力する関数(最初に実行)
     */
    function logRedirectUriAndAuthUrl() {
      const service = getMoneyForwardService();
      
      Logger.log('【重要】以下のリダイレクトURIをマネーフォワードのアプリ設定に登録してください:');
      Logger.log(service.getRedirectUri());
      
      if (!service.hasAccess()) {
        Logger.log('--------------------------------');
        Logger.log('以下のURLをブラウザで開いて、マネーフォワードの認証を許可してください:');
        Logger.log(service.getAuthorizationUrl());
      } else {
        Logger.log('既に認証済みです。APIを実行できます。');
        Logger.log('※もしスコープを変更した場合は、一度 resetAuth() を実行してから再認証してください。');
      }
    }
    
    /**
     * 認証完了後にマネーフォワードからリダイレクトされるコールバック関数
     */
    function authCallback(request) {
      const service = getMoneyForwardService();
      const authorized = service.handleCallback(request);
      if (authorized) {
        return HtmlService.createHtmlOutput('認証が成功しました!このタブを閉じてGASエディタに戻ってください。');
      } else {
        return HtmlService.createHtmlOutput('認証に失敗しました。設定を確認してください。');
      }
    }
    
    /**
     * 認証情報をリセットしたい場合に実行する関数
     */
    function resetAuth() {
      getMoneyForwardService().reset();
      Logger.log('認証情報をリセットしました。スコープを変更した場合は、再度 logRedirectUriAndAuthUrl を実行してください。');
    }

    次に、GASエディタの「プロジェクト設定」を開きスクリプトプロパティにClient Secretを設定します。プロパティ名は"CLIENT_SECRET"とし、値にアプリ登録画面からコピペした値を貼り付け、「スクリプトプロパティを保存」を押して保存してください。

    この設定により、コードに直接Client Secretを記載せずにすみ、コードのコピペなどによりキーが流出するのを防ぎます。

    画像

    2.OAuth2ライブラリの追加

    1. GASのエディタ左側のメニューから「ライブラリ」の横の「+」をクリックします。

    2. スクリプトID 1B7FSrk5Zi6L1rSxxTDgDEUsPzlukDsi4KGuTMorsTQHhGBzBkMun4iDF
      を入力し、「検索」をクリックします。

    3. 「OAuth2」と表示されたら「追加」をクリックします。

    画像

    GASエディタのライブラリ欄にOAuth2というライブラリが追加されていれば成功です。

    画像

    3.初回認証を行う

    1. 関数を選択して実行
      GASエディタの上部にある関数選択ドロップダウン(「実行」ボタンの左側)から、logRedirectUriAndAuthUrl を選択して「実行」をクリックします。

    2. ログを確認
      画面下部の「実行ログ」に以下のようなURLが出力されます。

      • リダイレクトURI: https://script.google.com/macros/d/【あなたのスクリプトID】/usercallback

      • 認証用URL: https://api.biz.moneyforward.com/authorize?...

    3. マネーフォワード側の設定
      Step2の手順で設定しているとは思いますが、出力された「リダイレクトURI」が、マネーフォワードの開発者サイト(アプリの設定画面)にある「リダイレクトURI」と一致しているか確認します。これが違うと次のステップでエラーになります。

    4. ブラウザで認証
      ログに出力された「認証用URL」をコピーして、ブラウザURL欄に貼り付け、新しいタブで開きます。マネーフォワードのログイン画面(またはアクセス許可画面)が表示されるので、「許可する」ボタンを押します。

    5. 認証完了!
      ブラウザに「認証が成功しました!このタブを閉じてGASエディタに戻ってください。」と表示されれば、初回の認証プロセスはすべて完了です。

    このステップにおける注意事項

    リダイレクトURIがアプリの設定と不一致の場合

    画像
    リダイレクトURIが違う場合、この画面のようなエラーが出ます。

    初回実行時にGAS自体の権限の承認が必要になる場合があります。その場合は「権限を確認」するをクリックし、承認をしてください。

    画像

    認証用URLにアクセスし、認証を進めていく中で、以下のような画面が表示されると思います。このアプリが要求する権限がAPIを活用する際の最小限の構成になっているか必ず確認してください。その仕組みに余計な権限は与えないようにしましょう。

    今回はチュートリアル用に勘定科目と補助科目の参照のみを与えます。

    画像

    認証に成功すると、下記のような画面がブラウザ上に表示されます。

    画像
    この画面に戻るようにセッティングするのがリダイレクトURIだったりします

    Step4:勘定科目の一覧を取得しよう。

    認証ができたら、準備は完全に終わりました。
    あとは、実際にAPIをたたいてみて動作を確認してみましょう。

    1.勘定科目の一覧を取得するために関するコード (Accounts.gs)を設定する

    GASエディタで「ファイル」>「+」>「スクリプト」から Accounts.gs という名前でファイルを作成し、以下のコードを貼り付けます。

    コード上部の"SPREADSHEET_ID"は書き込みたいスプレッドシートのIDに書き換えてください。

    // ==========================================
    // Accounts.gs: 勘定科目の取得とスプレッドシートへの転記
    // ==========================================
    
    // TODO: 転記先となる特定のスプレッドシートIDを指定してください
    // (URLの /d/ と /edit の間にある長い文字列です)
    const SPREADSHEET_ID = 'あなたのスプレッドシートIDをここに記述';
    
    /**
     * 勘定科目一覧を取得し、スプレッドシートの「勘定科目」シートに転記するメイン関数
     */
    function exportAccountsToSheet() {
      // Auth.gsで定義した関数を呼び出してサービスを取得
      const service = getMoneyForwardService();
    
      // 認証が済んでいない場合はエラーを出す
      if (!service.hasAccess()) {
        Logger.log('エラー: 認証されていません。Auth.gsの logRedirectUriAndAuthUrl を実行して認証を済ませてください。');
        return;
      }
    
      // 勘定科目APIのエンドポイント
      const url = 'https://api-accounting.moneyforward.com/api/v3/accounts';
      
      const options = {
        method: 'get',
        headers: {
          Authorization: 'Bearer ' + service.getAccessToken()
        },
        muteHttpExceptions: true
      };
    
      const response = UrlFetchApp.fetch(url, options);
      
      // ステータスコード200(成功)の処理
      if (response.getResponseCode() === 200) {
        const json = JSON.parse(response.getContentText());
        const accounts = json.accounts; //
        
        Logger.log('合計 %s 件の勘定科目を取得しました。スプレッドシートへ転記します...', accounts.length);
        
        // --------------------------------------------------
        // ▼ スプレッドシートへの書き込み処理
        // --------------------------------------------------
        
        // 1. スプレッドシートと対象シートの取得
        const ss = SpreadsheetApp.openById(SPREADSHEET_ID);
        let sheet = ss.getSheetByName('勘定科目');
        
        // もし「勘定科目」シートがなければ自動で新規作成する
        if (!sheet) {
          sheet = ss.insertSheet('勘定科目');
        } else {
          // 既存のシートがあれば、前回のデータを一度クリアする
          sheet.clear();
        }
        
        // 2. 転記用データの作成(まずは1行目のヘッダーを用意)
        const data = [
          ['勘定科目ID', '勘定科目名称', '勘定グループ', 'カテゴリ', '財務諸表区分', '税区分ID', '検索キー', '有効状態']
        ];
        
        // 3. APIで取得したデータを1行ずつ配列に変換して追加
        accounts.forEach(account => {
          data.push([
            account.id,                       // 勘定科目ID
            account.name,                     // 名称
            account.account_group,            // 資産・負債などのグループ
            account.category,                 // 詳細カテゴリ
            account.financial_statement_type, // BS/PLなどの区分
            account.tax_id,                   // 税区分ID
            account.search_key || '',         // 検索キー
            account.available ? '有効' : '無効' // 有効かどうかのフラグ
          ]);
        });
        
        // 4. スプレッドシートの指定範囲に一括で書き込み(処理速度が圧倒的に速い方法です)
        sheet.getRange(1, 1, data.length, data[0].length).setValues(data);
        
        Logger.log('スプレッドシートへの転記が完了しました!シートを確認してください。');
        
      } else {
        Logger.log('APIエラーが発生しました: ステータスコード %s', response.getResponseCode()); //
        Logger.log(response.getContentText());
      }
    }

    2.コードを実行してみよう

    • スプレッドシートIDの取得と設定 出力させたいスプレッドシートをブラウザで開き、URLを確認してください。 https://docs.google.com/spreadsheets/d/【ここの長い英数字】/edit... この 【ここの長い英数字】 の部分をコピーして、コード上部の SPREADSHEET_ID の中身に貼り付けます。

    • 実行時の権限承認 初めてスプレッドシートを操作する関数を実行する際、Googleから「このアプリがあなたのスプレッドシートを操作しようとしています」という警告(承認リクエスト)が出ます。「詳細を表示」→「(安全ではないページ)に移動」をクリックして許可してください。

    • 実行 関数選択ドロップダウンから exportAccountsToSheet を選んで実行します。

    画像

    スプレッドシートの勘定科目というシートに勘定科目の一覧が表示されていればAPIでの連携成功です!

    マネーフォワード クラウド会計API 連携手順のまとめ

    Step 1: アプリ登録と権限の確認
    まずはマネーフォワードのアプリポータルにアクセスし、自身のユーザー権限に「システム管理」と「アプリ開発」が付与されているか確認します。その後、権限の編集画面から「クラウド会計・確定申告」のアプリ連携権限を有効にします。

    Step 2: APIアプリの作成と情報の取得
    アプリ開発メニューから新規登録を行い、アプリ名称やGAS用のリダイレクトURI、認証方式(BASIC推奨)を設定して登録します。登録後に発行される「Client ID」と「Client Secret」は、プログラムからアクセスするための重要な情報(鍵)となるため厳重に保管します。

    Step 3: GASでのOAuth2認証設定
    GASのエディタを開き、認証用のコード(Auth.gs)を作成します。コード内にClient IDや連携したいAPIの権限(スコープ)を設定し、Client Secretは情報漏洩を防ぐためにスクリプトプロパティに登録します。その後、GASにOAuth2ライブラリを追加し、初回認証用の関数を実行してブラウザ上でマネーフォワードからのアクセス許可(認証)を完了させます。

    Step 4: APIを実行してスプレッドシートへ出力(動作確認)
    認証完了後、実際にAPIを動かすためのコード(Accounts.gs)を作成します。出力先となるGoogleスプレッドシートのIDを指定し、勘定科目の一覧を取得する関数を実行します。スプレッドシートに勘定科目の一覧が正常に出力されていれば、連携は成功です。

    この基本的なセットアップができれば、あとはGASのコード上で権限(スコープ)を追加・変更することで、他の様々なAPI連携も可能になります。

     
     
    会計事務所や税理士事務所の視点から生成AIの活用に関して様々な視点から情報を提供していきます。#推しはGemini

    あなたへのおすすめ