免费在 GitHub 公开中文介绍

freee-api-skill

通过freee API参考资料和操作示例，协助查询及更新费用、交易、考勤、发票和项目工时等数据，并提供连接设置、认证错误排查及事业务所确认指引。

原文查看原文说明

freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告・サイン（電子契約）の詳細APIリファレンスと使い方ガイドを提供。

freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・SaaSアカウント管理・備品管理・固定資産管理・業務委託先の企業ユーザー/部門管理・サーベイ企画/実施回の取得・開業申請用データの参照/更新・人事評価結果の取得・法人税申告データや帳票の参照・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。

ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、IT管理、固定資産管理、業務委託管理、サーベイ、開業、人事評価、申告、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。

freee/freee-mcp

集成工具freee

AI 评分90分/ 100 查看安装方法

此技能的介绍文章

freee会計や勤怠をAIで操作する ― freee-api-skill
文章介绍了适合哪些人、能带来什么、使用示例和注意事项（日文）。

适用场景

在freee申请报销或登记交易
查询考勤与员工信息
制作发票和报价单
登记项目实际工时
查看电子合同文档

中文介绍

功能

通过API规范和操作示例，协助办理freee费用申请、交易登记、考勤、发票和工时等业务。使用连接AI与freee的工具freee-mcp查询及更新数据。除会计、人事劳务外，还涵盖销售、IT管理、固定资产及日本企业所得税申报表单查询，并说明连接设置和认证错误的处理方法。

适用场景

适合让智能体查询或登记freee数据，或查找API所需输入字段。常见操作有相应流程示例，先确认目标事业务所，再查阅必要规范并执行。

使用示例

“请确认当前事业务所，将这笔支出登记为交易。”
“请查询本月考勤和员工信息。”
“我想登记这个项目的实际工时，请查找必填字段。”

注意事项

需要连接freee-mcp并完成认证。电子合同另需设置freee-sign-mcp。调查问卷、日本开业申报、人事评价等部分API仅限远程版，文件上传仅限本地模式。操作对象须与所选事业务所一致。许可证为Apache-2.0。

本介绍由 AI（OpenAI Codex）根据公开的 SKILL.md 撰写。准确的规格请查看下方原文。

客观评估

AI 仅根据 SKILL.md 的内容，从 4 个方面进行了评估。星标数和热度不计入评估。

指令清晰度能否看出何时使用、做什么: A良好明确说明通过freee-mcp操作数据及提供API规范的用途。
步骤具体性步骤、输入输出和示例是否具体: A良好列出工具名称及确认事业务所、查阅流程与规范、调用API的步骤。
安全性发送数据、删除文件、执行命令等是否有说明: B部分不足要求核对事业务所，但未明确调用删除API前的确认条件。
安装难易度所需工具和 API 密钥是否少且有说明: A良好说明连接和认证前提，指向SETUP.md，并提供连接模式的检查方法。

总分按每项 A=25 分、B=15 分、C=5 分相加。由 AI（OpenAI Codex）于 2026年10月19日评估。仅供参考，安装前请同时查看原文。

如果您认为评估有误，请申请复核

包含的文件（197）

SKILL.md12.0 KB
apm.yml311 B
COLORS.md526 B
evals/evals.json24.5 KB
recipes/corporate-tax-return-operations.md11.6 KB
recipes/deal-operations.md2.3 KB
recipes/expense-application-operations.md1.9 KB
recipes/fixed-asset-management-operations.md6.4 KB
recipes/freee-mcp-tag.md1.2 KB
recipes/hr-attendance-operations.md1.8 KB
recipes/hr-employee-operations.md1.9 KB
recipes/invoice-operations.md3.5 KB
recipes/it-management-operations.md15.3 KB
recipes/launch-operations.md7.6 KB
recipes/manual-journal-operations.md2.9 KB
recipes/partner-management-operations.md10.0 KB
recipes/payment-request-operations.md2.0 KB
recipes/pm-operations.md2.3 KB
recipes/pm-workload-registration.md3.2 KB
recipes/receipt-operations.md2.5 KB
recipes/report-operations.md1.8 KB
recipes/sign-document-operations.md7.1 KB
recipes/sm-operations.md4.9 KB
recipes/survey-operations.md11.1 KB
references/accounting-account-groups.md2.2 KB
references/accounting-account-items.md11.0 KB
references/accounting-approval-flow-routes.md2.9 KB
references/accounting-approval-requests.md13.0 KB
references/accounting-banks.md2.2 KB
references/accounting-companies.md3.1 KB
references/accounting-deals.md15.3 KB
references/accounting-expense-application-currencies.md2.5 KB
references/accounting-expense-application-forms.md6.0 KB
references/accounting-expense-application-line-templates.md12.2 KB
references/accounting-expense-applications.md21.2 KB
references/accounting-fixed-assets.md2.3 KB
references/accounting-general-ledgers.md3.9 KB
references/accounting-invoices.md2.3 KB
references/accounting-items.md9.4 KB
references/accounting-journals.md5.0 KB
references/accounting-manual-journals.md14.7 KB
references/accounting-partners.md30.7 KB
references/accounting-payment-requests.md30.4 KB
references/accounting-payments.md3.0 KB
references/accounting-purchase-requests.md10.5 KB
references/accounting-quotations.md2.0 KB
references/accounting-receipts.md6.4 KB
references/accounting-renews.md6.4 KB
references/accounting-sections.md10.8 KB
references/accounting-segment-tags.md9.4 KB
references/accounting-selectables.md1.1 KB
references/accounting-tags.md5.9 KB
references/accounting-taxes.md4.5 KB
references/accounting-transfers.md24.4 KB
references/accounting-trial-balance.md53.2 KB
references/accounting-user-matchers.md16.5 KB
references/accounting-users.md10.9 KB
references/accounting-wallet-txns.md5.3 KB
references/accounting-walletables.md9.1 KB
references/employee-evaluation-evaluation-results.md1.3 KB
references/fixed-asset-management-fixed-assets.md13.7 KB
references/hr-approval-flow-routes.md1.9 KB
references/hr-attendance-summaries.md6.4 KB
references/hr-attendances.md5.2 KB
references/hr-bonus-statements.md1.8 KB
references/hr-employee-bank-accounts.md2.3 KB
references/hr-employee-base-pay.md2.1 KB
references/hr-employee-custom-fields.md1.0 KB
references/hr-employee-dependents.md10.2 KB
references/hr-employee-health-insurance.md6.4 KB
references/hr-employee-pension-insurance.md4.7 KB
references/hr-employee-profiles.md6.3 KB
references/hr-employee-special-leaves.md549 B
references/hr-employees.md9.8 KB
references/hr-groups.md2.0 KB
references/hr-login-user.md814 B
references/hr-monthly-attendance-closing-requests.md7.9 KB
references/hr-overtime-requests.md10.8 KB
references/hr-paid-holiday-requests.md17 B
references/hr-paid-leave-requests.md7.5 KB
references/hr-payroll-statements.md2.9 KB
references/hr-positions.md1.7 KB
references/hr-sections.md2.5 KB
references/hr-special-holiday-requests.md8.8 KB
references/hr-time-clocks.md3.8 KB
references/hr-work-record-summaries.md1.9 KB
references/hr-work-record-tags.md1.8 KB
references/hr-work-time-correction-requests.md12.6 KB
references/hr-year-end-adjustments.md26.0 KB
references/INDEX.md7.8 KB
references/invoice-delivery-slips.md12.0 KB
references/invoice-invoices.md14.4 KB
references/invoice-payment-notices.md8.7 KB
references/invoice-purchase-orders.md11.6 KB
references/invoice-quotations.md9.6 KB
references/invoice-receipts.md11.0 KB
references/it-management-application-account.md6.6 KB
references/it-management-application-masters.md2.4 KB
references/it-management-applications.md4.9 KB
references/it-management-asset-attributes.md5.3 KB
references/it-management-asset-categories.md3.5 KB
references/it-management-asset-locations.md4.2 KB
references/it-management-asset-members.md5.3 KB
references/it-management-asset-statuses.md3.2 KB
references/it-management-assets.md7.3 KB
references/it-management-custom-application-masters.md2.8 KB
references/it-management-departments.md4.7 KB
references/it-management-employment-types.md4.4 KB
references/it-management-guests.md3.7 KB
references/it-management-members.md7.7 KB
references/it-management-positions.md3.5 KB
references/it-management-product-companies.md4.3 KB
references/it-management-system-account-owners.md4.6 KB
references/launch-kaigyo-application.md11.2 KB
references/partner-management-orderer-company-users.md2.9 KB
references/partner-management-orderer-sections.md849 B
references/partner-management-partner-management-orderer-partners.md5.0 KB
references/partner-management-partner-management-orderer-project-business-partners.md1.1 KB
references/partner-management-partner-management-orderer-project-company-users.md1.0 KB
references/partner-management-partner-management-orderer-project-partners.md1.4 KB
references/partner-management-partner-management-orderer-projects.md3.0 KB
references/partner-management-partner-management-orderer-task-delivery-data-custom-fields.md1.1 KB
references/partner-management-partner-management-orderer-task-line-items-custom-fields.md1.1 KB
references/partner-management-partner-management-orderer-task-line-items.md997 B
references/partner-management-partner-management-orderer-tasks.md18.5 KB
references/pm-daily-attendances.md1.6 KB
references/pm-labor-budgets.md1.6 KB
references/pm-partners.md419 B
references/pm-people.md744 B
references/pm-project-tag-groups.md546 B
references/pm-projects.md8.4 KB
references/pm-sales-order-statuses.md468 B
references/pm-teams.md410 B
references/pm-unit-costs.md421 B
references/pm-users.md674 B
references/pm-workload-tag-groups.md501 B
references/pm-workloads.md3.8 KB
references/sm-advance-receipts.md19.8 KB
references/sm-businesses.md8.6 KB
references/sm-cost-budgets.md7.0 KB
references/sm-deliveries.md15.6 KB
references/sm-master.md2.2 KB
references/sm-other-costs.md5.1 KB
references/sm-periodic-sales.md13.7 KB
references/sm-procurements.md14.3 KB
references/sm-purchase-orders.md13.7 KB
references/sm-quotations.md13.6 KB
references/sm-sales-orders.md12.2 KB
references/sm-sales-schedules.md6.0 KB
references/sm-sales.md11.8 KB
references/survey-surveys.md4.4 KB
references/tax-return-corporate.md8.9 KB
SETUP.md2.1 KB
SIGN-GUIDE.md3.2 KB
sign-references/sign-documents.md44.4 KB
sign-references/sign-folders.md425 B
sign-references/sign-items.md3.3 KB
sign-references/sign-kintone.md157 B
sign-references/sign-seal-images.md334 B
sign-references/sign-teams.md1.6 KB
sign-references/sign-templates.md1.2 KB
sign-references/sign-users.md5.7 KB
tax-return-references/10200000.md8.1 KB
tax-return-references/10600100.md8.6 KB
tax-return-references/10603100.md9.3 KB
tax-return-references/10700100.md11.8 KB
tax-return-references/10800100.md11.8 KB
tax-return-references/11000600.md7.1 KB
tax-return-references/11400200.md11.2 KB
tax-return-references/11500000.md4.7 KB
tax-return-references/206000000.md23.4 KB
tax-return-references/206000430.md30.3 KB
tax-return-references/206000900.md8.8 KB
tax-return-references/220000000.md15.8 KB
tax-return-references/301001000.md7.6 KB
tax-return-references/401001000.md40.6 KB
tax-return-references/402001000.md4.5 KB
tax-return-references/99500328.md29.9 KB
tax-return-references/99500352.md8.6 KB
tax-return-references/balance_sheet.md126.5 KB
tax-return-references/beppyo-01.md46.5 KB
tax-return-references/beppyo-04.md42.7 KB
tax-return-references/beppyo-05.md48.9 KB
tax-return-references/beppyo-11.md15.9 KB
tax-return-references/beppyo-16.md41.3 KB
tax-return-references/cost_report.md21.6 KB
tax-return-references/index.md34.0 KB
tax-return-references/notes_to_financial_statements.md38.9 KB
tax-return-references/profit_and_loss.md143.0 KB
tax-return-references/statements_of_shareholders.md155.0 KB
tax-return-references/uchiwakesho.md47.2 KB
tax-return-references/zeimu-dairi-kengen.md31.6 KB
troubleshooting/auth.md1.7 KB
troubleshooting/company.md1.2 KB
troubleshooting/expense-errors.md3.0 KB
troubleshooting/INDEX.md993 B
troubleshooting/support.md1.3 KB

SKILL.md（原文）

安装前可以查看交给 AI 代理的指令内容。

freee API スキル

概要

freee の会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告のデータを AI から直接操作できるスキルです。

freee-mcp (MCP サーバー) を通じて freee API と連携。

このスキルの役割:

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

セットアップ

freee_* ツールが利用できている場合、セットアップは不要です。

以下のいずれかに該当する場合のみ SETUP.md を読み、ユーザーに接続手順を案内してください。

freee_* ツールが1つも利用できない
freee_auth_status が未認証を返し、「エラー対応」の手順でも解決しない
ユーザーが接続方法・初期設定について質問している

接続モードは freee_server_info の transport フィールドで確認できます（remote = Remote MCP、stdio = ローカル）。

リファレンス

API リファレンスが references/ に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの情報があります。

目的の API を探す手順:

references/INDEX.md を読む（service ごとのファイル名と内容の一覧）
索引で特定できない場合は references/ 内のファイルをキーワード検索する

リファレンスの記法:

名前* は必須、無印は任意
見出しの ### リクエストボディ* はリクエストボディ自体が必須であることを示す
パラメータは特記なき限り query。(path) (header) は該当箇所に明記
パラメータ名末尾の [] はパラメータ名の一部であり API 呼び出し時に省略してはいけない
GET /xxx と同じ は、同一ファイル内の該当エンドポイントと内容が同一であることを示す
レスポンスはトップレベルの項目のみ記載。ネストした構造は実際に API を呼び出して確認する

法人税の帳票 XML（XTX / XBRL）の各要素と紙の帳票の項目との対応は tax-return-references/ にあります。索引と共通仕様は tax-return-references/index.md にあり、帳票ごとのファイルはその索引の帳票一覧から sheet_code で引きます（系列の別表や内訳書は 1 ファイルに複数帳票をまとめています）。

使い方

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

accounting - freee会計（取引、勘定科目、取引先など）例: /api/1/deals
hr - freee人事労務（従業員、勤怠など）例: /api/v1/employees
invoice - freee請求書（請求書、見積書、納品書）例: /invoices
pm - freee工数管理（プロジェクト、工数など）例: /projects
sm - freee販売（見積、受注、売上など）例: /businesses
it_management - freeeIT管理（メンバー、SaaSアカウント、アプリ、備品、部署、会社など）例: /hub/it_management/members
fixed_asset_management - freee固定資産（固定資産の一覧、詳細、登録、更新、削除）例: /hub/fixed_asset_management/fixed_assets
partner_management - freee業務委託管理（業務委託先の企業ユーザー・部門）例: /hub/partner_management/orderer/company_users
survey - freeeサーベイ（サーベイ企画、実施回）※ freee-mcp（リモート版）限定例: /hub/survey/base_surveys
launch - freee開業（開業申請用データの参照・更新）※ freee-mcp（リモート版）限定例: /hub/launch/kaigyo_application
employee_evaluation - 人事評価（人事評価結果の取得）※ freee-mcp（リモート版）限定例: /hub/employee_evaluation/evaluation_results
tax_return - freee申告（法人税申告・帳票参照）例: /hub/tax_return/corporate

基本ワークフロー

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

事業所を確認: freee_get_current_company で現在の事業所IDを取得する（初回は必須。セッション内で1回取得すれば以降は使い回せる）
- APIは事業所ごとにデータが分離されているため、正しい事業所を選択しないと意図しないデータにアクセスしてしまう
レシピを確認: recipes/ 内の該当レシピを読む
- よくある操作のパターンと注意点がまとまっているため、直接APIを叩くより効率的でミスが少ない
リファレンスを検索: 必要に応じて references/INDEX.md から該当ファイルを引く
- レシピにない詳細なパラメータやレスポンス仕様を確認する
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/partner-management-operations.md - 業務委託管理（パートナー・企業ユーザー・部門・プロジェクト・タスクの参照）
recipes/it-management-operations.md - IT管理（メンバー・SaaSアカウント・アプリ・備品・部署・会社など）
recipes/survey-operations.md - サーベイ（サーベイ企画・実施回の取得）
recipes/launch-operations.md - 開業（開業申請用データの参照・更新）
recipes/fixed-asset-management-operations.md - 固定資産管理（安全な更新・削除判断・Web画面への引き継ぎ）
recipes/corporate-tax-return-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 のデータをグラフ・表・HTML 等で可視化する場合は COLORS.md を読み、そこで指定された配色を使うこと。

エラー対応

バージョン確認: 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
詳細: troubleshooting/INDEX.md 参照（症状別に auth / company / expense-errors / support へ分かれています）

freee-mcp（リモート版）限定のエンドポイントについて

一部のAPIエンドポイントは freee-mcp（リモート版）でのみ利用可能で、ローカルモードでは利用できない。該当する recipes/ references/ には「⚠ freee-mcp（リモート版）限定」の注記がある。

該当エンドポイントを呼び出す前に freee_server_info で transport を確認し、stdio（ローカルモード）の場合は呼び出さず、ユーザーに freee-mcp（リモート版）への切り替え（設定方法）を案内すること。

API の機能制限について

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

评价

还没有评价。欢迎分享你的使用感受。

无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

报告此技能的问题

安装

用命令安装

npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill

粘贴到终端中运行（需要 Node.js）。可以选择安装到 Claude Code、Codex 等代理。

让代理安装

请安装以下 Agent Skill。
https://github.com/freee/freee-mcp/tree/main/skills/freee-api-skill

请先检查 SKILL.md 和附带文件的内容，确认没有可疑的处理（向外部发送数据、读取认证信息等）后，再放到 ~/.claude/skills/freee-api-skill/（Claude Code）或 ~/.agents/skills/freee-api-skill/（Codex）。

把这段文字直接发给 Claude Code 或 Codex，它会先检查内容再安装。

在 GitHub 查看源代码

仓库: freee/freee-mcp
星标: 508
复刻: 58
分类: 商务
许可证: Apache-2.0
原文语言: 日语
最后更新: 2026年10月16日

技能是给 AI 代理的指令和脚本的集合。cccskills 不保证其内容的安全性，安装前请务必确认内容。

此技能的介绍文章

适用场景

中文介绍

功能

适用场景

使用示例

注意事项

客观评估

包含的文件（197）

SKILL.md（原文）

freee API スキル

概要

セットアップ

リファレンス

使い方

MCP ツール

基本ワークフロー

レシピ

freee サイン（電子契約）

データの可視化

エラー対応

freee-mcp（リモート版） 限定のエンドポイントについて

API の機能制限について

评价

评论

freee-mcp（リモート版）限定のエンドポイントについて