freee MCP×Claude Code連携｜会計AIで経理を効率化する方法

freee公式MCPサーバー「freee-mcp」とClaude Codeを連携させれば、自然言語の指示だけで会計・請求書・給与データをAIエージェントが直接操作できます。月次決算チェックや請求書処理を自動化し、経理担当者が判断業務に集中できる環境が実現します。

本記事は2026年8月時点の情報です。

「freeeにデータは入っているのに、月次の集計は結局Excelに落として手作業で計算している」

「未入金の請求書を確認するために、毎月たくさんの画面を1件ずつ開いてチェックしている」

「受注はHubSpot、入金はfreee。2つのツールを行き来しないと数字を合わせられない」

——経理や経営企画の現場では、こうした課題を抱えるケースが少なくありません。freeeを導入してクラウド会計に移行しても、データの確認・集計・レポート作成は依然として人間の手作業に依存しているケースが大半です。

freee-mcpとは、freee株式会社が公開しているMCP（Model Context Protocol）対応のサーバーで、Claude CodeなどのAIエージェントからfreeeの会計・請求書・人事労務データへ直接アクセスできる仕組みです。MCPとはAnthropicが提唱するプロトコルで、AIエージェントと外部サービスをUSB-Cのように統一インターフェースで接続します。「今月の試算表を出して」「未入金の請求書を一覧にして」といった自然言語の指示だけで、freeeのデータ取得・集計・操作をAIエージェントに任せられるようになります。

MCPの基本概念については「Claude Code MCP連携の始め方｜HubSpot・freee・Slackを接続する設定手順」で詳しく解説していますので、あわせてご覧ください。

出典: freee-mcp GitHub リポジトリ

この記事でわかること

freeeの会計データをAIエージェントで直接操作したいCFO・経理担当者・CDO（最高デジタル責任者）に向けて、freee-mcpの仕組みからセットアップ、実務活用、HubSpotとの併用までを整理しています。

• freee-mcpが対応する5つのAPI — 会計・人事労務・請求書・工数管理・販売のデータにアクセスできる範囲と、それぞれの活用シーンを整理します
• Agent SkillsとOAuth 2.0+PKCE認証の仕組み — AIがfreeeのAPI仕様と操作手順を自動で理解し、安全に操作できる設計を解説します
• リモート／ローカル2通りのセットアップ手順 — /mcpコマンドによる接続からCLAUDE.mdの業務ルール記述までを具体的なコマンド付きで紹介します
• 月次決算・請求書処理・採算分析・経費チェックの4つの活用パターン — 自然言語の指示例と、freee-mcpが裏側で実行する処理の流れを紹介します
• freee×HubSpot×Claude Codeの統合活用と、AIに任せる範囲・人間が判断すべき範囲の線引き — 経理・営業・経営企画をまたぐデータ突合と、書き込み操作の運用ルールを紹介します

freee-mcpの導入を検討している方に向けて書いています。最後まで読むと、自社の経理業務のどこをAIエージェントに任せ、どこを人間が判断すべきかの切り分けができるようになります。

freee-mcpとは：freee公式のAIエージェント接続基盤

freee-mcpは、AIエージェントに「freeeのAPI仕様書を渡す」のではなく「freeeの業務知識ごと渡す」設計になっている点が特徴です。単なるデータ接続の入り口ではなく、経理担当者が頭の中で持っている「この操作の前にはこのデータを確認する」といった手順ごとAIに引き継げる仕組みだと捉えると理解しやすくなります。ここでは対応APIと、精度を支える2つの仕組みを整理します。

freee-mcpの概要と対応API

freee-mcpは、freee株式会社がGitHub上でオープンソースとして公開しているMCPサーバーです。Anthropicが策定したModel Context Protocol（MCP）に準拠しており、Claude DesktopやClaude Codeから直接freeeの各種APIにアクセスできます。

freee-mcpが対応している5つのAPIは以下の通りです。

出典: freee-mcp README

この5つのAPIを1つのMCPサーバー経由で横断できる点が、freeeの管理画面をタブごとに開いて確認していた従来の運用との大きな違いです。会計と工数管理を別々に見比べる必要がなくなり、AIエージェントへの一度の指示で複数APIをまたいだ集計が可能になります。情報が分散した状態を解消し、1つの入口から一元管理するという考え方は、CRM設計で重視している考え方と同じです。

Agent Skills：freeeの業務知識をAIに注入する仕組み

freee-mcpの特筆すべき機能が「Agent Skills」です。通常のMCPサーバーは、AIエージェントにAPIのエンドポイント一覧を提供するだけですが、freee-mcpはそれに加えて、APIリファレンスと操作レシピ（手順書）をAIエージェントのコンテキストに自動注入します。

たとえば「売上高の月次推移を出して」と指示した場合、Agent Skillsが適切なAPIエンドポイント、必要なパラメータ、レスポンスの解釈方法をClaude Codeに提供します。これにより、AIエージェントがAPIの仕様を「理解」した上で操作を行うため、誤ったパラメータの送信やデータの誤解釈が減少します。

freee-mcpのAgent Skillsは、単なるAPI接続を超えた「AIエージェント向け業務マニュアル」だといえます。APIのエンドポイント情報だけでなく、「この操作を行うには先にこのデータを取得する必要がある」といった操作手順まで含まれているため、Claude Codeは複雑な会計操作も正しい順序で実行できます。個人の経験や勘に頼るのではなく、業務知識を仕組みとしてAIに引き継ぐ設計になっている点は、経理業務を標準化したい企業にとって導入しやすいポイントだと考えています。

OAuth 2.0 + PKCE認証：セキュリティと利便性の両立

freee-mcpの認証にはOAuth 2.0 + PKCE（Proof Key for Code Exchange）が採用されています。PKCEはパブリッククライアント（CLIツールなど、クライアントシークレットを安全に保持できない環境）向けに設計された認証フローで、以下の特長があります。

• 認証コードの横取り攻撃を防止する追加のセキュリティレイヤー
• トークンの自動リフレッシュにより、セッション中に再認証が不要
• 複数事業所の動的切り替えに対応し、グループ企業の管理にも対応

APIトークンを.envファイルに保存する従来の方法と比較して、PKCEベースの認証はトークン漏洩のリスクを低減できます。認証まわりの設計がしっかりしているからこそ、経理という機密性の高いデータを扱うMCPサーバーとして安心して検討しやすくなっていると考えています。

Claude Codeにfreee-mcpをセットアップする手順

セットアップはリモート接続とローカル接続の2通りがあります。いきなり本番環境の書き込み権限まで開放するのではなく、まずは読み取り系の指示で接続を確認し、慣れてから書き込み操作を許可していくスモールスタートを推奨します。全てを一気に進めるのは難しいため、自社で活用できそうな範囲から優先順位をつけて試す進め方が現実的です。

前提条件

freee-mcpをセットアップする前に、以下の準備が必要です。

• freeeの開発者アカウントとアプリケーション登録（freee Developers Communityで取得）
• Claude Codeの動作環境（Node.js 18以上）
• freeeのOAuth 2.0クライアントID・クライアントシークレット

リモートMCPサーバーとして接続する方法

freee-mcpはリモートMCPサーバーとしての接続に対応しています。Claude Codeの/mcpコマンドを使って設定します。

# Claude Codeのセッション内で実行
/mcp add freee-mcp -- npx @anthropic-ai/remote-mcp-server https://mcp.freee.co.jp/sse

リモートMCPサーバーを利用する場合、ローカル環境にfreee-mcpをインストールする必要はありません。接続後にブラウザでfreeeのOAuth認証画面が開き、アクセスを許可するだけでセットアップが完了します。初めてfreee-mcpを試す場合は、まずこのリモート接続から始めるとつまずきにくいと考えています。

ローカルセットアップの方法

セキュリティ要件やネットワーク制約により、ローカルでMCPサーバーを動作させたい場合は、以下の手順でセットアップします。

# freee-mcpをクローン
git clone https://github.com/freee/freee-mcp.git
cd freee-mcp

# 依存パッケージのインストール
npm install

# 環境変数の設定
export FREEE_CLIENT_ID="your_client_id"
export FREEE_CLIENT_SECRET="your_client_secret"

# MCPサーバーの起動
npm start

Claude Code側では、.claude/settings.jsonに以下のようにMCPサーバーの設定を追加します。

{
  "mcpServers": {
    "freee-mcp": {
      "command": "node",
      "args": ["/path/to/freee-mcp/dist/index.js"],
      "env": {
        "FREEE_CLIENT_ID": "${FREEE_CLIENT_ID}",
        "FREEE_CLIENT_SECRET": "${FREEE_CLIENT_SECRET}"
      }
    }
  }
}

設定後、Claude Codeを再起動するとfreee-mcpが自動的に接続されます。/mcpコマンドでサーバーの接続状態を確認してください。社内で複数人がローカルセットアップを行う場合は、.claude/settings.jsonをテンプレート化して配布すると、担当者ごとに設定内容がばらつく事態を避けやすくなります。

2つの接続方式の違いを整理すると、以下のようになります。

初回認証フロー

freee-mcpを初めて使用する際は、OAuth 2.0 + PKCEの認証フローが実行されます。

1. Claude Codeでfreeeのデータにアクセスする操作を実行
2. ブラウザが自動的に開き、freeeのログイン画面が表示される
3. freeeアカウントでログインし、アクセス権限を許可
4. 認証トークンが自動的に保存され、以降はトークンリフレッシュで再認証不要

# 認証状態の確認（Claude Code内でfreee-mcpのツールを使用）
# freee_auth_status ツールで現在の認証状態を確認できる

HubSpot ゴールドパートナーが開発・提供

HubSpotの取引情報をもとに、freee側で見積書・請求書を作成したいという要望に対応します。HubSpotゴールドパートナーのStartLinkが開発した連携アプリ「Sync for freee」は、取引情報から見積書・請求書を発行し、取引先・品目のマスタを同期します。無料プランから試せます。HubSpotマーケットプレイスからインストールできます。

実務での活用パターン：月次決算からレポート生成まで

freee-mcpの価値は、個別の機能単体ではなく「月次決算→請求書処理→採算分析→経費チェック」という経理業務の一連の流れの中でどこに位置づけるかで決まります。以下は代表的な4つの活用パターンです。ただし、いずれも最終判断は人間が行う前提で設計してください。

パターン1：月次決算の自動チェック

経理担当者が月末に行う決算チェックをClaude Codeで自動化する例です。

# Claude Codeへの指示例
「今月の試算表を取得して、前月比で10%以上変動している
勘定科目をリストアップしてください。変動理由の仮説も添えてください」

Claude Codeはfreee-mcpを通じて以下の操作を自動実行します。

1. freee会計APIで当月・前月の試算表データを取得
2. 勘定科目ごとに前月比を計算
3. 10%以上の変動がある科目を抽出
4. 過去の仕訳データから変動理由を推定

従来であれば、freeeの管理画面でレポートをダウンロードし、Excelで前月比を計算し、変動理由を個別に調査する必要がありました。この一連の作業が、1つの自然言語の指示で完結します。ここで大事なのは、AIが出した「変動理由の仮説」はあくまで一次情報であり、最終的に決算数値として確定させるかどうかの判断は経理担当者が行うという役割分担です。

パターン2：請求書の一括処理とステータス確認

# Claude Codeへの指示例
「今月発行した請求書のうち、入金確認が取れていないものを一覧表示して。
金額が大きい順にソートし、発行日から30日以上経過しているものにはフラグを付けてください」

freee-mcpの請求書APIを通じて、未入金の請求書を即座にリストアップできます。手作業でfreeeの請求書画面を1件ずつ確認する手間を減らせます。金額の大きい順・経過日数によるフラグ付けまでを指示に含められるため、督促の優先順位付けもAIエージェントに任せやすいパターンです。

パターン3：プロジェクト別の採算分析

工数管理APIと会計APIを組み合わせることで、プロジェクト単位での採算分析が可能です。

# Claude Codeへの指示例
「工数管理から今月のプロジェクト別の稼働時間を取得し、
会計データの外注費と合わせてプロジェクト別の粗利を計算してください」

工数管理と会計は本来別々の画面で管理されているデータですが、freee-mcpが両方のAPIに接続できるため、Claude Codeの1つのセッション内で突き合わせて粗利を算出できます。

パターン4：経費精算の異常値チェック

# Claude Codeへの指示例
「今月の経費精算データを取得して、過去6ヶ月の平均と比較して
2倍以上の金額になっている勘定科目を教えてください」

月次の経費が異常に増加しているケースを自動検出し、予算管理に役立てることができます。ただし、こうした異常値検出はあくまで一次スクリーニングです。実際に不正や誤処理があったかどうかの判断は、経理担当者が個別の証憑を確認したうえで行う業務であり、AIエージェントに最終判断を委ねる運用には向きません。

AIに任せる範囲と人間が判断すべき範囲

freee-mcpのようにAIエージェントが会計データを直接操作できるようになると、「どこまで任せてよいのか」という線引きが運用設計の中心的な論点になります。上の4つのパターンに共通しているのは、データ収集・集計・一次スクリーニングはAIエージェントが担い、金額や証憑にもとづく最終判断は人間が行うという役割分担です。

AIエージェントが得意な領域

前月比の計算、未入金請求書の抽出、プロジェクト別の粗利計算、経費の異常値スクリーニングといった、決まったロジックにもとづく集計・抽出作業はAIエージェントの得意領域です。手作業であれば数時間かかっていたレポート作成が、自然言語の指示1回で完結します。

以下の画面は、HubSpotのAI機能「Breeze」が条件に合ったレコードのプロパティを一括で自動編集している例です。このように、決まったロジックにもとづく大量データの抽出・更新・集計は、AIエージェントが得意とする領域だと捉えています。

人間が判断すべき領域

一方で、変動理由の最終確認、証憑にもとづく不正・誤処理の判定、仕訳の確定操作といった、金額の確定や会社としての意思決定を伴う判断は人間が行う領域です。ただし「仕訳の作成・更新」のような書き込み操作自体はfreee-mcpで実行可能なため、運用ルールとしてどこまでAIに任せるかを事前に決めておく必要があります。

企業様によって扱う仕訳の量や事業所数は異なるため、どこまでAIに任せるかの最適な線引きも会社ごとに変わってくると考えています。まずは読み取り系の集計業務からAIエージェントに任せ、書き込み操作は「下書き→レビュー→確定」のフローで段階的に広げていくアプローチが現実的です。

freee×HubSpot×Claude Code：三位一体の経営管理

CRMは単なる顧客データベースではなく、事業成長のエンジンだと考えています。HubSpotで管理している受注データと、freeeで管理している入金データを別々のツールで見ていると、「リード→商談→受注（HubSpot）」から「請求書発行→入金確認（freee）」までの流れのどこかで情報が分断されがちです。この一気通貫のデータフローをAIエージェントで横断的に扱えることが、freee-mcpとHubSpot MCPを併用するメリットの1つです。

CRMデータと会計データの突合が経営判断を変える

Claude CodeにHubSpot MCPとfreee-mcpの両方を接続すれば、1つのセッション内で以下のような横断分析が可能です。

# Claude Codeへの指示例
「HubSpotの今月のクローズ済み取引一覧と、freeeの今月の売上仕訳を突合して、
金額の不一致がある取引をリストアップしてください」

freee単体では「いくら入金があったか」しかわかりません。HubSpot単体では「いくら受注したか」しかわかりません。両方のデータをAIエージェントが横断的に分析することで、「受注から入金までのリードタイム」「顧客別のLTV（生涯価値）」「月次の予実差異の原因」といった、経営の意思決定に直結するインサイトが得られます。コンタクトから取引、請求までの全体フローの中にfreee-mcpを位置づけると、単なる経理の効率化ではなく経営判断の基盤として活用できます。

StartLinkが実践するfreee×HubSpot連携

HubSpotゴールドパートナーのStartLinkは、HubSpotとfreeeを連携するアプリ「Sync for freee」を開発・提供しています。Sync for freeeはHubSpotの取引データを元にfreeeの請求書を自動生成するアプリで、HubSpot App Marketplaceに掲載されています。

以下の画面は、StartLink公式サイトのSyncプロダクトページに設置されている「StartLinkサポートAI」チャットです。

freee-mcpとHubSpot MCPをClaude Codeに同時接続することで、Sync for freeeが自動処理した請求書のステータスを横断的に確認したり、CRMのパイプラインデータと会計データの整合性をリアルタイムで検証したりすることが可能になります。この「freee（会計）×HubSpot（CRM）×Claude Code（AIエージェント）」の三位一体は、従来であれば経理・営業・経営企画の3部門がそれぞれ別のツールで管理していたデータを、1つのAIエージェントが統合的に分析・操作できる環境を実現します。

複数事業所の管理とチーム運用

freee-mcpは1つの事業所だけでなく、グループ企業やフランチャイズ展開をしている企業の複数事業所を横断的に扱える設計になっています。一方でチームで運用する場合は、個人の使い方に依存させず、認証・権限・レビューのルールをあらかじめ仕組みとして定めておくことが重要です。

複数事業所の動的切り替え

グループ企業やフランチャイズ展開をしている企業では、事業所ごとの会計データを横断的に分析する必要がありますが、freee-mcpなら以下のように操作できます。

# Claude Codeへの指示例
「事業所Aと事業所Bの今月の売上高を比較して、前年同月比も含めて表にしてください」

freee-mcpのfreee_list_companiesツールで利用可能な事業所を一覧表示し、freee_set_current_companyツールで操作対象の事業所を切り替えます。Claude Codeのセッション内で事業所を切り替えながら、グループ全体のデータを集計できます。

チーム運用時のセキュリティ考慮事項

freee-mcpをチームで運用する際は、以下のセキュリティ上の注意点を押さえてください。

特に重要なのは、書き込み操作に対する人間のレビューです。AIエージェントが仕訳を自動作成する運用は効率的ですが、作成された仕訳を経理担当者が確認してから確定する（下書き→レビュー→確定）というフローを設計することを推奨します。企業様によって扱う仕訳の量や事業所数は異なるため、どこまでAIに任せるかの最適な線引きも会社ごとに変わってくると考えています。

トラブルシューティングと運用のコツ

freee-mcpは便利な反面、認証やレートリミットまわりでつまずきやすいポイントがいくつかあります。ここでは代表的なエラーと、属人的な対応に頼らず仕組みで再現性を持たせる運用のコツを紹介します。

よくあるエラーと対処法

freee-mcp利用時に遭遇しやすい問題と対処法をまとめます。

認証エラー（401 Unauthorized）: トークンの有効期限が切れている場合に発生します。freee-mcpはトークンの自動リフレッシュ機能を備えていますが、リフレッシュトークン自体の有効期限が切れた場合は再認証が必要です。freee_authenticateツールで再認証してください。

事業所アクセスエラー: 選択した事業所に対するアクセス権限がない場合に発生します。freeeの管理画面で、APIアプリケーションに対して該当事業所へのアクセス権限が付与されているか確認してください。

レートリミット: freee APIにはレートリミット（リクエスト回数制限）があります。大量のデータを一括取得する場合は、適切なページネーション処理とリクエスト間隔の調整が必要です。freee-mcpはこの制御を内部で処理しますが、短時間に大量のリクエストを発行する指示は避けてください。

運用効率を上げるCLAUDE.mdの設定

Claude Codeのプロジェクト設定ファイル（CLAUDE.md）にfreee関連の業務ルールを記述しておくと、AIエージェントの操作精度が向上します。

# 会計処理ルール
- 売上高の勘定科目コードは XXXXXX のみを本業売上として集計する
- freeeのtype=incomeにはBS取引（資本金等）が混入するため注意
- 会計年度は9月始まり（9/1〜8/31）
- 月次決算チェック時は、前月比10%以上の変動がある科目を報告する

このようにドメイン固有のルールをCLAUDE.mdに明記しておくことで、担当者ごとの指示の仕方への依存を減らし、誰が使っても同じ観点で自社の会計ルールに沿った操作を行いやすい仕組みになります。特定の担当者しか正しい指示を出せないという属人化を避けられる点は、経理業務にAIエージェントを導入する際に重視したいポイントです。

AIの振る舞いをあらかじめルールとして定義しておく考え方は、他のAIエージェント運用にも共通しています。以下の画面は、HubSpotの顧客対応AI（Breezeカスタマーエージェント）のガイドライン設定画面で、トーンや応答スタイルをルールとして設定できるようになっています。

よくある質問

Q1. freee-mcpは無料で利用できますか？

freee-mcpはGitHub上でオープンソースとして公開されており、MCPサーバー自体の利用は無料です。ただし、freee APIの利用にはfreeeの有料プランの契約とAPIアプリケーションの登録が必要です。また、Claude Codeの利用にはAnthropicのサブスクリプション（Claude Pro / Max / Team / Enterprise）が必要です。

Q2. freee-mcpでデータの書き込み（仕訳作成・請求書発行）はできますか？

はい、freee-mcpはfreee APIの読み取り操作だけでなく、書き込み操作（POST・PUT・PATCH・DELETE）にも対応しています。ただし、会計データの書き込みは不可逆な操作を含むため、運用上は「AIエージェントが下書きを作成→人間がレビュー→確定」というフローを推奨します。

Q3. Claude Desktop版とClaude Code版のどちらで使うべきですか？

定型的なレポート生成やデータ確認にはClaude Desktop版が手軽です。一方、複数のMCPサーバーを組み合わせた横断分析（freee×HubSpot×Slack等）や、CLAUDE.mdによる業務ルールの注入が必要な場合はClaude Code版が適しています。チームでの運用や自動化パイプラインの構築を見据えるなら、Claude Codeをおすすめします。

Q4. セキュリティ面で不安があります。freeeの認証情報はどこに保存されますか？

freee-mcpはOAuth 2.0 + PKCEを採用しており、認証トークンはローカル環境（~/.config/freee-mcp/）に保存されます。APIキーをコード内にハードコードする方式と比較して、トークンの自動リフレッシュとスコープ制限による安全な運用がしやすくなります。トークンファイルのアクセス権限を適切に設定し、.gitignoreでの除外を徹底してください。

Q5. freee-mcpとSync for freee（HubSpot連携アプリ）の違いは何ですか？

Sync for freeeはHubSpotの取引データを元にfreeeの請求書を自動生成するHubSpotアプリで、特定のワークフロー（受注→請求書発行）を自動化します。一方、freee-mcpはfreee APIへの汎用的なアクセス基盤であり、AIエージェントを通じて会計・人事労務・請求書・工数管理・販売の全APIを操作できます。Sync for freeeで定型業務を仕組み化し、freee-mcpで非定型の分析・レポートをAIに任せるという使い分けが効果的だと考えています。

まとめ：AIエージェントが経理業務のパートナーになる

freee-mcpとClaude Codeの連携で実現できることを整理します。

• 月次決算チェック・請求書の一括処理・プロジェクト別採算分析が、自然言語の指示だけで完結する環境が整っています
• freee-mcpのAgent Skills機能は単なるAPI接続ではなく、freeeのドメイン知識をAIエージェントに注入する設計です。会計の専門知識がなくても適切なAPI操作を実行できます
• データ収集・集計・一次スクリーニングはAIエージェント、金額の確定や証憑にもとづく判断は人間、という役割分担を運用ルールとして事前に決めておくことが、経理業務にAIエージェントを取り入れる際のポイントです
• HubSpot MCPと組み合わせることで、CRMの受注データと会計の入金データを1つのAIセッションで横断分析できます。部門やツールの壁を越えた経営判断がしやすくなります

最初の一歩としては、以下の3ステップをおすすめします。

1. まずはリモートMCPサーバーへの接続を試し、読み取り系の指示（試算表の確認・未入金請求書の一覧化など）だけで挙動を確認する
2. 自社の会計ルール（勘定科目・会計年度・変動チェックの閾値など）をCLAUDE.mdに書き出し、指示の再現性を仕組み化する
3. 慣れてきたら書き込み操作を「下書き→レビュー→確定」のフローで段階的に許可し、HubSpot MCPとの併用も検討する

CRMを活用した業務効率化やAIとの連携に関するご相談は、CRM特化型コンサルティングのHubSpotゴールドパートナーのStartLinkまでお気軽にお問い合わせください。

あわせて読みたい

• Claude Code MCP連携の始め方｜HubSpot・freee・Slackを接続する設定手順
• AI活用完全ガイド
• Sync for freee（HubSpot×freee連携アプリ）