freee-api-skill

freee API スキル

概要

freee の会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・申告のデータを AI から直接操作できるスキルです。

freee-mcp (MCP サーバー) を通じて freee API と連携。

このスキルの役割:

• freee API の詳細リファレンスを提供
• freee-mcp 使用ガイドと API 呼び出し例を提供

セットアップ

freee_* ツールが利用できている場合、セットアップは不要です。

以下のいずれかに該当する場合のみ SETUP.md を読み、ユーザーに接続手順を案内してください。

• freee_* ツールが1つも利用できない
• freee_auth_status が未認証を返し、「エラー対応」の手順でも解決しない
• ユーザーが接続方法・初期設定について質問している

接続モードは freee_server_info の transport フィールドで確認できます（remote = Remote MCP、stdio = ローカル）。

リファレンス

API リファレンスが references/ に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの情報があります。

目的の API を探す手順:

1. references/INDEX.md を読む（service ごとのファイル名と内容の一覧）
2. 索引で特定できない場合は references/ 内のファイルをキーワード検索する

リファレンスの記法:

• 名前* は必須、無印は任意
• 見出しの ### リクエストボディ* はリクエストボディ自体が必須であることを示す
• パラメータは特記なき限り query。(path) (header) は該当箇所に明記
• パラメータ名末尾の [] はパラメータ名の一部であり API 呼び出し時に省略してはいけない
• GET /xxx と同じ は、同一ファイル内の該当エンドポイントと内容が同一であることを示す
• レスポンスはトップレベルの項目のみ記載。ネストした構造は実際に API を呼び出して確認する

法人税の帳票 XML（XTX / XBRL）の各要素と紙の帳票の項目との対応は tax-return-references/ にあります。索引と共通仕様は tax-return-references/index.md、個別の帳票は tax-return-references/{sheet_code}.md です。

使い方

MCP ツール

認証・事業所管理:

• freee_authenticate - OAuth 認証（Remote MCP では認証は自動処理されるため通常は不要）
• freee_auth_status - 認証状態確認
• freee_clear_auth - 認証情報クリア（ローカルモード用）
• freee_current_user - ログインユーザー情報取得
• freee_list_companies - 事業所一覧
• freee_set_current_company - 事業所切り替え
• freee_get_current_company - 現在の事業所取得

サーバー情報:

• freee_server_info - サーバー情報取得（バージョン、transport: remote/stdio）

ファイル操作:

• freee_file_upload - ファイルボックスにファイルをアップロード (POST /api/1/receipts) ※ローカルモードのみ

API 呼び出し:

• freee_api_get - GET リクエスト
• freee_api_post - POST リクエスト
• freee_api_put - PUT リクエスト
• freee_api_delete - DELETE リクエスト
• freee_api_patch - PATCH リクエスト
• freee_api_list_paths - 利用可能なAPIパス一覧

serviceパラメータ (必須):

• accounting - freee会計（取引、勘定科目、取引先など） 例: /api/1/deals
• hr - freee人事労務（従業員、勤怠など） 例: /api/v1/employees
• invoice - freee請求書（請求書、見積書、納品書） 例: /invoices
• pm - freee工数管理（プロジェクト、工数など） 例: /projects
• sm - freee販売（見積、受注、売上など） 例: /businesses
• it_management - freeeIT管理（SaaSアカウント、備品、メンバー） 例: /hub/it_management/members
• fixed_asset_management - freee固定資産（固定資産の一覧、詳細、登録、更新、削除） 例: /hub/fixed_asset_management/fixed_assets
• partner_management - freee業務委託管理（業務委託先の企業ユーザー・部門） 例: /hub/partner_management/orderer/company_users
• survey - freeeサーベイ（サーベイ企画、実施回）※ freee-mcp（リモート版） 限定 例: /hub/survey/base_surveys
• tax_return - freee申告（法人税申告・帳票参照） 例: /hub/tax_return/corporate