freee-api-skill
freee 会計・人事労務 API を MCP 経由で操作するスキル。詳細なAPIリファレンスと使い方ガイドを提供。
When & Why to Use This Skill
The freee API Skill for Claude enables seamless integration with freee's Accounting and HR/Labor Management platforms via the Model Context Protocol (MCP). This powerful tool allows users to automate complex financial and administrative tasks—such as managing accounting deals, processing expense applications, and updating employee records—directly through Claude. By providing a bridge to the freee ecosystem, it streamlines back-office workflows and enhances productivity for businesses using freee's SaaS solutions.
Use Cases
- Automated Expense Management: Streamline the submission and approval process for employee expenses by interacting with the freee HR and Accounting APIs through natural language.
- Financial Record Keeping: Efficiently create, update, and retrieve accounting deals, journal entries, and transaction records to ensure real-time financial accuracy.
- HR and Attendance Tracking: Manage employee profiles and monitor attendance data, making it easier to handle payroll preparation and workforce management.
- Invoice and Document Automation: Generate, send, and track professional invoices, quotations, and delivery slips using the integrated freee Invoice service tools.
- Project Cost Management: Monitor project-specific costs and man-hours by leveraging the freee Project Management (PM) API integration.
| name | freee-api-skill |
|---|---|
| description | "freee 会計・人事労務 API を MCP 経由で操作するスキル。詳細なAPIリファレンスと使い方ガイドを提供。" |
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") を使用してください。