MCP｜公式 freee MCP を使って、請求書周りや会計業務を自動化する（Claude Desktop / Claude Code）

Last updated at 2026-03-03Posted at 2026-03-03

概要

会計ソフト「freee」から公式MCPが登場したので、これで請求書の確認・メール送信や会計業務を楽にしようと設定・利用方法をまとめた備忘録。

公式記事によると、freee 所属のエンジニアが個人的にOSSとして開発したものを、会社が公式OSSとして引き継いだものとのこと。

「確定申告」を全自動化することも考えましたが、現状では「支援する使い方で、いつもより楽にする」が、個人的に最適な印象です。

前提

筆者のマシン（PC）は macOS です
マシンに Node.js が導入済みであること
事前に freee のアカウント（事業所設定含む）を用意していること
- freee 開発者アカウントを作って、テスト用のダミー事業所を用意・利用してもOK
今回は、Claude Desktop アプリから利用することをゴールとする
- Claude Code での設定も、合わせて簡単に記載
実際に、過去の実績を元に請求書の送付を試してみるまでを実施

手順

1. freee 側でアプリ登録

freeeアプリストアにアクセス

ページ内の「今すぐアプリを作成」をクリック

アプリ作成画面が現れるので、以下を参考に基本設定を入力

アプリ名：任意（freee MCP など）
概要：任意（MCP利用のためのアプリ など）
アプリタイプ：非公開で良いので「プライベートアプリ」を選択

「作成」ボタンを押すと、未ログインの場合は「ログイン」「事業所選択」を求められるので、ログインしてアカウントを選択する。

認証も作成も成功すると、作成したアプリ詳細ページが表示される。
ここで、「コールバックURL」には、http://127.0.0.1:54321/callback を設定しておくこと（公式リポジトリの README.md に記載されている）。
画面内の「Client ID」「Client Secret」を後で設定に利用するので控えておく（ただし、機密情報なので外部に漏れないように注意すること）。

「権限設定」タブを選択し、どこまでMCPでできる様にするかを設定する。
一覧表にある「参照」「更新」は、いわゆる Read / Write 権限 と思えばよい。

基本的に任意なので全部チェックしても良いが、必要なものだけに絞った方が良い（私は「会計」と「請求書」関連を使うので、そちらの参照と一部の更新をチェックした）。

選択したら「下書き保存」をクリック。
「え、下書き保存でいいの？」 と、ちょっとわかりにくいが、今回は 「プライペートアプリ（非公開）」 なので、これで保存としては完了になる。

2. freee-mcp のインストールと認証

GitHub をクローンして特定ファイルを node コマンドで実行する方法もあるが、より簡単な方法として npm インストール方式を採用する。

ターミナルを起動して、npm で公式パッケージをグローバルインストール

npm i -g freee-mcp

続けて、初期設定・認証をするコマンドを実行

freee-mcp configure

コマンドを実行すると、以下の様に対話式ウィザードが始まるので、質問されたことに回答していく。

=== freee-mcp Configuration Setup ===

このウィザードでは、freee-mcpの設定と認証を対話式で行います。
freee OAuth認証情報が必要です。

ステップ 1/3: OAuth認証情報の入力

freee アプリのコールバックURLには http://127.0.0.1:54321/callback を設定してください。

? FREEE_CLIENT_ID: › # 👈 先ほど控えた情報を貼り付ける
? FREEE_CLIENT_SECRET: › # 👈 先ほど控えた情報を貼り付ける
? コールバックポート (コールバックURL: http://127.0.0.1:<port>/callback): › 54321 👈 デフォルトで良いのでそのまま Enter キー

認証情報を受け取りました。

ステップ 2/3: OAuth認証

ブラウザで認証ページを開きます...
📦 古い設定形式を検出しました。新しい形式に移行します...
Warning: 環境変数での認証情報設定は非推奨です。
  `freee-mcp configure` を実行して設定ファイルに移行してください。
  環境変数設定は将来のバージョンで削除される予定です。

OAuth callback server listening on http://127.0.0.1:54321 (callback URL: http://127.0.0.1:54321/callback)

認証URL: https://accounts.secure.freee.co.jp/public_api/authorize?response_type=code&client_id=***&redirect_uri=http%3A%2F%2F127.0.0.1%3A54321%2Fcallback&scope=read+write&state=***&code_challenge=***&code_challenge_method=S256

ブラウザで認証を完了してください...
認証が完了すると自動的に次のステップに進みます。

上記のように２ステップ完了すると、自動で Web ブラウザが開き、承認を求められるので、画面最下部の「許可する」をクリックして認証を完了する。

認証が完了すると、以下の様に事業所選択を確認されるので、デフォルトとなる事業所を選択して Enter キーで確定する。

Callback request: GET /callback?code=***
Callback received - URL: http://127.0.0.1:54321/callback?code=***
Callback parameters: {
  code: '***...',
  state: '***...',
  error: null,
  errorDescription: null
}
Pending authentications count: 0
Valid CLI callback received
認証コードを受け取りました。
トークンを取得中...
Callback request: GET /favicon.ico
[info] Creating directory: /Users/***/.config/freee-mcp
[info] Writing tokens to: /Users/***/.config/freee-mcp/tokens.json
[info] Tokens saved successfully
トークンを取得しました。

ステップ 3/3: デフォルト事業所の選択

事業所一覧を取得中...
? デフォルトの事業所を選択してください: › - Use arrow-keys. Return to submit.
❯   {事業所名} (ID: ********) - admin # 👈 Enter キーを押す



# 👇 選択すると
{事業所名} を選択しました。

設定情報を保存しました。

認証情報は ~/.config/freee-mcp/config.json に保存されました。
トークンは ~/.config/freee-mcp/tokens.json に保存されました。

最後に MCP 設定を自動で行うか確認される（Claude Code / Claude Desktop がある場合）

=== MCP設定 ===

Claude Code / Claude Desktop に freee-mcp を設定できます。

# 👇 以下の様に聞かれるので、そのまま Enter キーを押せば良い
? Claude Code に freee-mcp を追加しますか? › (Y/n)
? Claude Desktop に freee-mcp を追加しますか? › (Y/n)



# 👇 設定完了すると
✔ Claude Code に freee-mcp を追加しますか? … yes
  ✓ Claude Code に freee-mcp を追加しました。
    設定ファイル: /Users/***/.claude.json

✔ Claude Desktop に freee-mcp を追加しますか? … yes
  ✓ Claude Desktop に freee-mcp を追加しました。
    設定ファイル: /Users/***/Library/Application Support/Claude/claude_desktop_config.json
    # Windows の場合: %APPDATA%\Claude\claude_desktop_config.json

=== Skill (API リファレンス) のインストール ===

MCP サーバーと合わせて Skill をインストールすると、API リファレンスが利用可能になります。

[Claude Code]
  以下のコマンドで freee API スキルをインストールできます:

  npx add-skill freee/freee-mcp

[Claude Desktop]
  1. 以下の URL から freee-skill.zip をダウンロード:
     https://github.com/freee/freee-mcp/releases/latest

  2. Claude Desktop でスキルをアップロード:
     Settings > Features > Skills > 「Upload skill」から zip ファイルを選択

セットアップ完了!
変更を反映するには、Claude Code / Claude Desktop を再起動してください。

OAuth callback server stopped

上記でインストールと認証は完了です。

尚、実際に保存された内容は以下で確認可能。

# 確認コマンド
$ cat ~/.config/freee-mcp/config.json

# 実行結果
{
  "clientId": "***", # 発行された ID
  "clientSecret": "***", # 発行されたシークレット
  "callbackPort": 54321,
  "defaultCompanyId": "*****", # 選択した事業所 ID
  "currentCompanyId": "*****", # 選択した事業所 ID
  "companies": {
    "*****": {
      "id": "*****",
      "name": "{事業所名}",
      "description": "Role: admin",
      "addedAt": 1772502617470,
      "lastUsed": 1772502617470
    }
  }
}