freee API スキル
概要
@him0/freee-mcp (MCP サーバー) を通じて freee API と連携。
このスキルの役割:
- freee API の詳細リファレンスを提供
- freee-mcp 使用ガイドと API 呼び出し例を提供
注意: OAuth 認証はユーザー自身が自分の環境で実行する必要があります。
セットアップ
1. OAuth 認証（あなたのターミナルで実行）
npx @him0/freee-mcp configure
ブラウザで freee にログインし、事業所を選択します。設定は ~/.config/freee-mcp/config.json に保存されます。
2. プラグインをインストール
- Claude Code: コマンドパレット → "Claude: Install Plugin" → このリポジトリのパス
- Claude Desktop: 設定 → Plugins → Add Plugin → このリポジトリのパス
3. 再起動して確認
Claude を再起動後、freee_auth_status ツールで認証状態を確認。
リファレンス
API リファレンスが references/ に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの詳細情報があります。
検索方法:
pattern: "経費"
path: "skills/freee-api-skill/references"
output_mode: "files_with_matches"
主なリファレンス:
accounting-deals.md- 取引accounting-expense-applications.md- 経費申請hr-employees.md- 従業員情報hr-attendances.md- 勤怠
使い方
MCP ツール
認証・事業所管理:
freee_authenticate- OAuth 認証freee_auth_status- 認証状態確認freee_list_companies- 事業所一覧freee_set_current_company- 事業所切り替え
API 呼び出し:
freee_api_get- GET リクエストfreee_api_post- POST リクエストfreee_api_put- PUT リクエストfreee_api_delete- DELETE リクエストfreee_api_patch- PATCH リクエスト
serviceパラメータ (必須):
| service | 説明 | パス例 |
|---|---|---|
accounting | freee会計 (取引、勘定科目、取引先など) | /api/1/deals |
hr | freee人事労務 (従業員、勤怠など) | /api/1/employees |
invoice | freee請求書 (請求書、見積書、納品書) | /invoices |
pm | freee工数管理 (プロジェクト、工数など) | /api/1/projects |
company_id について
リクエストに company_id を含める場合、現在設定されている事業所（freee_get_current_company で確認可能）と一致している必要があります。不一致の場合はエラーになります。
- 事業所を変更する場合: 先に
freee_set_companyで切り替えてからリクエストを実行 - company_id を含まない API（例:
/api/1/companies）: そのまま実行可能
基本ワークフロー
- 操作ガイドを確認:
docs/内の該当ガイドを読む - リファレンスを検索: 必要に応じて
references/を参照 - API を呼び出す:
freee_api_*ツールを使用
操作ガイド
よくある操作の使用例とTipsは以下を参照:
docs/expense-application-operations.md- 経費申請docs/deal-operations.md- 取引（収入・支出）docs/hr-operations.md- 人事労務（従業員・勤怠）docs/invoice-operations.md- 請求書・見積書・納品書
エラー対応
- 認証エラー:
freee_auth_statusで確認 →freee_clear_auth→freee_authenticate - 事業所エラー:
freee_list_companies→freee_set_current_company - 詳細:
docs/troubleshooting.md参照
対応 API
| service | ベースURL | パス形式 |
|---|---|---|
accounting | https://api.freee.co.jp | /api/1/... |
hr | https://api.freee.co.jp/hr | /api/1/... |
invoice | https://api.freee.co.jp/iv | /invoices, /quotations, /delivery_slips |
pm | https://api.freee.co.jp/pm | /api/1/... |
請求書 API について
請求書・見積書・納品書の操作については docs/invoice-operations.md を参照してください。
注意: 会計 API の /api/1/invoices は過去の API であり、現在は請求書 API (service: "invoice") を使用してください。