freee-api-skill

分类: 开发与编程 | 上传者: freee | 下载: 0 | 版本: v1.0（最新）

freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・サイン（電子契約）の詳細APIリファレンスと使い方ガイドを提供。freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。

更新日志: Source: GitHub https://github.com/freee/freee-mcp

目录结构

当前层级: tree/main/skills/freee-api-skill/

📁 evals/
- 📄 evals.json 12.3 KB
📁 recipes/
- 📄 deal-operations.md 3.6 KB
- 📄 expense-application-operations.md 2.5 KB
- 📄 freee-mcp-tag.md 1.1 KB
- 📄 hr-attendance-operations.md 2.2 KB
- 📄 hr-employee-operations.md 2.1 KB
- 📄 invoice-operations.md 3.1 KB
- 📄 manual-journal-operations.md 3.4 KB
- 📄 payment-request-operations.md 2.9 KB
- 📄 pm-operations.md 2.6 KB
- 📄 pm-workload-registration.md 5.1 KB
- 📄 receipt-operations.md 4.0 KB
- 📄 report-operations.md 2.3 KB
- 📄 sm-operations.md 2.7 KB
- 📄 troubleshooting.md 10.4 KB
📁 references/
- 📄 accounting-account-groups.md 1.3 KB
- 📄 accounting-account-items.md 19.7 KB
- 📄 accounting-approval-flow-routes.md 5.8 KB
- 📄 accounting-approval-requests.md 29.1 KB
- 📄 accounting-banks.md 2.2 KB
- 📄 accounting-companies.md 18.2 KB
- 📄 accounting-deals.md 17.8 KB
- 📄 accounting-expense-application-line-templates.md 8.1 KB
- 📄 accounting-expense-applications.md 39.3 KB
- 📄 accounting-fixed-assets.md 5.8 KB
- 📄 accounting-general-ledgers.md 4.8 KB
- 📄 accounting-invoices.md 15.5 KB
- 📄 accounting-items.md 10.5 KB
- 📄 accounting-journals.md 3.6 KB
- 📄 accounting-manual-journals.md 14.7 KB
- 📄 accounting-partners.md 45.9 KB
- 📄 accounting-payment-requests.md 45.8 KB
- 📄 accounting-payments.md 6.6 KB
- 📄 accounting-quotations.md 12.4 KB
- 📄 accounting-receipts.md 12.7 KB
- 📄 accounting-renews.md 10.6 KB
- 📄 accounting-sections.md 16.1 KB
- 📄 accounting-segment-tags.md 7.8 KB
- 📄 accounting-selectables.md 2.0 KB
- 📄 accounting-tags.md 4.7 KB
- 📄 accounting-taxes.md 4.1 KB
- 📄 accounting-transfers.md 8.7 KB
- 📄 accounting-trial-balance.md 132.1 KB
- 📄 accounting-user-matchers.md 30.0 KB
- 📄 accounting-users.md 25.6 KB
- 📄 accounting-wallet-txns.md 9.1 KB
- 📄 accounting-walletables.md 9.1 KB
- 📄 hr-approval-flow-routes.md 4.1 KB
- 📄 hr-attendance-summaries.md 10.5 KB
- 📄 hr-attendances.md 7.1 KB
- 📄 hr-bonus-statements.md 5.0 KB
- 📄 hr-employee-bank-accounts.md 4.3 KB
- 📄 hr-employee-base-pay.md 3.5 KB
- 📄 hr-employee-custom-fields.md 1.6 KB
- 📄 hr-employee-dependents.md 25.7 KB
- 📄 hr-employee-health-insurance.md 15.1 KB
- 📄 hr-employee-pension-insurance.md 10.0 KB
- 📄 hr-employee-profiles.md 15.4 KB
- 📄 hr-employee-special-leaves.md 2.6 KB
- 📄 hr-employees.md 16.2 KB
- 📄 hr-groups.md 4.4 KB
- 📄 hr-login-user.md 1.8 KB
- 📄 hr-monthly-attendance-closing-requests.md 17.1 KB
- 📄 hr-overtime-requests.md 24.2 KB
- 📄 hr-paid-holiday-requests.md 173 B
- 📄 hr-paid-leave-requests.md 8.7 KB
- 📄 hr-payroll-statements.md 9.3 KB
- 📄 hr-positions.md 3.3 KB
- 📄 hr-sections.md 5.1 KB
- 📄 hr-special-holiday-requests.md 23.5 KB
- 📄 hr-time-clocks.md 5.7 KB
- 📄 hr-work-record-summaries.md 2.6 KB
- 📄 hr-work-record-tags.md 3.3 KB
- 📄 hr-work-time-correction-requests.md 18.7 KB
- 📄 hr-year-end-adjustments.md 86.3 KB
- 📄 invoice-delivery-slips.md 42.9 KB
- 📄 invoice-invoices.md 47.9 KB
- 📄 invoice-quotations.md 36.0 KB
- 📄 invoice-receipts.md 39.9 KB
- 📄 pm-partners.md 1.2 KB
- 📄 pm-people.md 1.8 KB
- 📄 pm-projects.md 6.7 KB
- 📄 pm-teams.md 1.1 KB
- 📄 pm-unit-costs.md 1.0 KB
- 📄 pm-users.md 1.3 KB
- 📄 pm-workloads.md 5.6 KB
- 📄 sm-businesses.md 3.7 KB
- 📄 sm-deliveries.md 4.1 KB
- 📄 sm-master.md 2.9 KB
- 📄 sm-sales-orders.md 3.7 KB
- 📄 sm-sales.md 4.0 KB
📁 sign-references/
- 📄 sign-documents.md 57.3 KB
- 📄 sign-folders.md 835 B
- 📄 sign-items.md 4.1 KB
- 📄 sign-kintone.md 331 B
- 📄 sign-seal-images.md 627 B
- 📄 sign-teams.md 2.0 KB
- 📄 sign-templates.md 2.9 KB
- 📄 sign-users.md 7.8 KB
📄 apm.yml 311 B
📄 SIGN-GUIDE.md 2.0 KB
📄 SKILL.md 9.4 KB

SKILL.md

---
name: freee-api-skill
description: "freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・サイン（電子契約）の詳細APIリファレンスと使い方ガイドを提供。freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。"
license: Apache-2.0
metadata:
  author: freee_jp
  homepage: https://github.com/freee/freee-mcp
---

# freee API スキル

## 概要

freee の会計・人事労務・請求書・工数管理・販売のデータを AI から直接操作できるスキルです。

[freee-mcp](https://www.npmjs.com/package/freee-mcp) (MCP サーバー) を通じて freee API と連携。

このスキルの役割:

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

接続方法は Remote MCP（推奨）とローカルの2つがあります。現在の接続モードは `freee_server_info` の transport フィールド（`remote` または `stdio`）で確認できます。

## セットアップ

### 方法 1: Remote MCP で接続する（推奨）

freee が提供する Remote MCP サーバーに接続する方法です。ローカルでのセットアップが不要で、すぐに利用を開始できます。

Claude 及び Claude Desktop では「カスタマイズ」より「カスタムコネクタを追加」を開き、以下を設定してください。

- 名前: `freee`
- URL: `https://mcp.freee.co.jp/mcp`

初回接続時にブラウザで freee への認証が自動的に行われます。`npx freee-mcp configure` の実行は不要です。

その他の AI ツールでは、それぞれの案内に従って Remote MCP サーバーを追加してください。

### 方法 2: ローカルで MCP サーバーを起動する

freee アプリケーションを自分で登録し、ローカルで MCP サーバーを起動する方法です。

```bash
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` - 請求書

## 使い方

### 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パラメータ (必須):

| service | 説明 | パス例 |
|---------|------|--------|
| `accounting` | freee会計 (取引、勘定科目、取引先など) | `/api/1/deals` |
| `hr` | freee人事労務 (従業員、勤怠など) | `/api/v1/employees` |
| `invoice` | freee請求書 (請求書、見積書、納品書) | `/invoices` |
| `pm` | freee工数管理 (プロジェクト、工数など) | `/projects` |
| `sm` | freee販売 (見積、受注、売上など) | `/businesses` |

### 基本ワークフロー

接続モードが不明な場合は `freee_server_info` で確認できます（transport が `remote` なら Remote MCP、`stdio` ならローカル）。Remote MCP の場合、認証は自動処理されるため手順1から開始できます。ローカルモードで未認証の場合は先に `freee_authenticate` を実行してください。

1. 事業所を確認: `freee_get_current_company` で現在の事業所IDを取得する（初回は必須。セッション内で1回取得すれば以降は使い回せる）
   - APIは事業所ごとにデータが分離されているため、正しい事業所を選択しないと意図しないデータにアクセスしてしまう
2. レシピを確認: `recipes/` 内の該当レシピを読む
   - よくある操作のパターンと注意点がまとまっているため、直接APIを叩くより効率的でミスが少ない
3. リファレンスを検索: 必要に応じて `references/` を参照
   - レシピにない詳細なパラメータやレスポンス仕様を確認する
4. API を呼び出す: `freee_api_*` ツールを使用（company_id が必要なエンドポイントでは手順1で取得した値を使う）

注意:
- `company_id` は現在設定されている事業所と一致している必要がある。不一致の場合はエラーになる
- 事業所を変更する場合: 先に `freee_set_current_company` で切り替えてからリクエストを実行

### レシピ

よくある操作のユースケースサンプルとTipsは以下を参照:

- `recipes/expense-application-operations.md` - 経費申請
- `recipes/deal-operations.md` - 取引（収入・支出）
- `recipes/manual-journal-operations.md` - 振替伝票
- `recipes/payment-request-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` - 販売管理（案件・受注）
- `recipes/report-operations.md` - 試算表・総勘定元帳（レポート取得・未承認仕訳の確認）
- `recipes/freee-mcp-tag.md` - メモタグ「freee-mcp」の付与ガイド

## freee サイン（電子契約）

freee サインは別の MCP サーバー（`freee-sign-mcp`）で提供されます。
`sign_api_get` 等のサインツールが利用可能な場合は `SIGN-GUIDE.md` を参照してください。

## カラールール

freee のデータを表示・可視化する際は、以下の色を使用してページ全体の統一感を保つこと。

文字色: 見出し `#1e46aa` / 本文 `#23418c` / キャプション `#323232` / リンク `#00b9b9` `#2864f0` `#1e46aa` / 強調 `#dc1e32`

背景色: メイン `#285ac8` / 薄い `#ebf3ff` / ニュートラル `#f7f5f5`

アクセントカラー（多用しない）: イエロー `#ffb91e` / オレンジ `#fa6414` / グリーン `#82c31e` / ティール `#00b9b9`

## エラー対応

- バージョン確認: `VERSION.md` を読んでスキルのバージョンを確認し（ファイルが存在しない場合は開発版を使用中）、`freee_server_info` でサーバーバージョンを確認してください。スキルのバージョンがサーバーより古い場合、スキルの情報が最新のサーバーに対応していない可能性があります。スキルを最新版に更新してから再度お試しください。
- 認証エラー（Remote MCP）: MCP クライアント（Claude Desktop 等）が自動的に再認証を促します。解決しない場合はカスタムコネクタを一度削除し、再度追加してください。
- 認証エラー（ローカル）: `freee_auth_status` で確認 → `freee_clear_auth` → `freee_authenticate`
- 事業所エラー: `freee_list_companies` → `freee_set_current_company`
- 詳細: `recipes/troubleshooting.md` 参照

## API の機能制限について

freee API 自体の機能制限に起因する問題は freee-mcp では解決できません。詳細は `recipes/troubleshooting.md` を参照してください。

## 関連リンク

- [freee-mcp](https://www.npmjs.com/package/freee-mcp)
- [freee API ドキュメント](https://developer.freee.co.jp/docs)
- Remote MCP サーバー: `https://mcp.freee.co.jp/mcp`

登录后下载/点赞/收藏 ❤ 423 | ★ 0

freee-api-skill

目录结构

SKILL.md

举报内容

提示