ideabrowser.com — find trending startup ideas with real demand
Try itnpx skills add https://github.com/freee/freee-mcp --skill freee-api-skillfreee-mcp (MCP サーバー) を通じて freee API と連携。
このスキルの役割:
注意: OAuth 認証はユーザー自身が自分の環境で実行する必要があります。
npx freee-mcp configure
ブラウザで freee にログインし、事業所を選択します。設定は ~/.config/freee-mcp/config.json に保存されます。
Claude を再起動後、freee_auth_status ツールで認証状態を確認。
API リファレンスが references/ に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの詳細情報があります。
目的のAPIを探すには、references/ ディレクトリ内のファイルをキーワード検索してください。
主なリファレンス:
accounting-deals.md - 取引accounting-expense-applications.md - 経費申請hr-employees.md - 従業員情報hr-attendances.md - 勤怠invoice-invoices.md - 請求書認証・事業所管理:
freee_authenticate - OAuth 認証freee_auth_status - 認証状態確認freee_clear_auth - 認証情報クリアfreee_current_user - ログインユーザー情報取得freee_list_companies - 事業所一覧freee_set_current_company - 事業所切り替えfreee_get_current_company - 現在の事業所取得サーバー情報:
freee_server_info - サーバー情報取得（バージョンなど）ファイル操作:
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パラメータ (必須):
| service | 説明 | パス例 |
|---|---|---|
accounting | freee会計 (取引、勘定科目、取引先など) | /api/1/deals |
hr | freee人事労務 (従業員、勤怠など) | /api/v1/employees |
invoice | freee請求書 (請求書、見積書、納品書) | /invoices |
pm | freee工数管理 (プロジェクト、工数など) | /projects |
sm | freee販売 (見積、受注、売上など) | /businesses |
freee_get_current_company で現在の事業所IDを取得する（初回は必須。セッション内で1回取得すれば以降は使い回せる）recipes/ 内の該当レシピを読むreferences/ を参照freee_api_* ツールを使用（company_id が必要なエンドポイントでは手順1で取得した値を使う）注意:
company_id は現在設定されている事業所と一致している必要がある。不一致の場合はエラーになるfreee_set_current_company で切り替えてからリクエストを実行よくある操作のユースケースサンプルとTipsは以下を参照:
recipes/expense-application-operations.md - 経費申請recipes/deal-operations.md - 取引（収入・支出）recipes/hr-employee-operations.md - 人事労務（従業員・給与）recipes/hr-attendance-operations.md - 勤怠（出退勤・打刻・休憩の登録）recipes/invoice-operations.md - 請求書・見積書・納品書recipes/receipt-operations.md - ファイルボックス（証憑ファイルのアップロード・管理）recipes/pm-operations.md - 工数管理（プロジェクト・工数実績）recipes/pm-workload-registration.md - 工数の安全な登録（PM・HR連携ワークフロー）recipes/sm-operations.md - 販売管理（案件・受注）VERSION.md を読んでスキルのバージョンを確認し、freee_server_info でサーバーバージョンを確認してください。スキルのバージョンがサーバーより古い場合、スキルの情報が最新のサーバーに対応していない可能性があります。スキルを最新版に更新してから再度お試しください。freee_auth_status で確認 → freee_clear_auth → freee_authenticatefreee_list_companies → freee_set_current_companyrecipes/troubleshooting.md 参照freee API 自体の機能制限に起因する問題は freee-mcp では解決できません。詳細は recipes/troubleshooting.md を参照してください。