freee-api-skilllisted

# freee API スキル ## 概要 [freee-mcp](https://www.npmjs.com/package/freee-mcp) (MCP サーバー) を通じて freee API と連携。 このスキルの役割: - freee API の詳細リファレンスを提供 - freee-mcp 使用ガイドと API 呼び出し例を提供 注意: OAuth 認証はユーザー自身が自分の環境で実行する必要があります。 > **リファレンス版数について**: 本スキルの API リファレンス（`references/` 72 件）は取り込み日 **2026-03-31** 時点のスナップショットです。freee API 仕様は更新されうるため、以降の変更は未反映の可能性があります。重要項目は `freee_api_list_paths` ツール／freee 公式ドキュメントで最新を確認してください。 ## セットアップ ### 1. OAuth 認証（あなたのターミナルで実行） ```bash npx freee-mcp configure ``` ブラウザで freee にログインし、事業所を選択します。設定は `~/.config/freee-mcp/config.json` に保存されます。 ### 2. 再起動して確認 Claude を再起動後、`freee_auth_status` ツールで認証状態を確認。 ## リファレンス API リファレンスが `references/` に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの詳細情報があります。 目的のAPIを探すには、`references/` ディレクトリ内のファイルをキーワード検索してください。 主なリファレンス: - `accounting-deals.md` - 取引 - `accounting-expense-applications.md` - 経費申請 - `hr-employees.md` - 従業員情報 - `hr-attendances.md` - 勤怠 - `invoice-invoices.md` - 請求書 ## 使い方 ### MCP ツール 認証・事業所管理: - `freee_authenticate` - OAuth 認証 - `freee_auth_status` - 認証状態確認 - `freee_clear_auth` - 認証情報クリア - `freee_current_user` - ログインユーザー情報取得 - `freee_list_companies` - 事業所一覧 - `freee_set_current_company` - 事業所切り替え - `freee_get_current_company` - 現在の事業所取得 ファイル操作: - `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