freee-api-skill
freee API 명세와 절차 예시로 경비, 거래, 근태, 청구서와 공수 데이터의 조회 및 갱신을 지원합니다. 연결 설정과 인증 오류 대응도 안내합니다.
원문원문 설명 보기
freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告・サイン(電子契約)の詳細APIリファレンスと使い方ガイドを提供。
freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・SaaSアカウント管理・備品管理・固定資産管理・業務委託先の企業ユーザー/部門管理・サーベイ企画/実施回の取得・開業申請用データの参照/更新・人事評価結果の取得・法人税申告データや帳票の参照・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。
ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、IT管理、固定資産管理、業務委託管理、サーベイ、開業、人事評価、申告、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。
이 스킬의 소개 기사
- freee会計や勤怠をAIで操作する ― freee-api-skill
누구에게 맞는지, 무엇을 얻을 수 있는지, 사용 예시와 주의 사항을 기사에서 소개합니다(일본어).
이럴 때 유용합니다
- freee에서 경비 신청과 거래 등록하기
- 근태와 직원 정보 확인하기
- 청구서와 견적서 만들기
- 프로젝트 공수 등록하기
- 전자 계약 문서 확인하기
한국어 소개
할 수 있는 일
API 명세와 절차 예시로 freee의 경비 신청, 거래 등록, 근태, 청구서, 공수 업무를 지원합니다. AI와 freee를 연결하는 도구인 freee-mcp를 통해 데이터를 조회하고 갱신합니다. 회계와 인사 노무 외에 판매, IT 관리, 고정 자산, 일본 법인세 신고 서식 조회도 다룹니다. 연결 설정과 인증 오류 대응도 안내합니다.
이럴 때 유용합니다
에이전트에게 freee 데이터 확인이나 등록을 맡기거나 API 입력 항목을 알아볼 때 유용합니다. 자주 쓰는 작업에는 절차 예시가 있으며, 대상 사업장을 확인한 뒤 필요한 명세를 참고해 진행합니다.
사용 예시
- “현재 사업장을 확인하고 이 지출을 거래로 등록해 주세요.”
- “이번 달 근태와 직원 정보를 확인해 주세요.”
- “이 프로젝트의 실제 공수를 등록하는 데 필요한 항목을 찾아 주세요.”
주의 사항
freee-mcp 연결과 인증이 필요합니다. 전자 계약에는 freee-sign-mcp를 별도로 설정합니다. 설문, 일본의 사업 개시 신고, 인사 평가 등 일부 API는 원격 버전에서만, 파일 업로드는 로컬 모드에서만 사용할 수 있습니다. 작업 대상과 선택한 사업장이 일치하는지 확인합니다. 라이선스는 Apache-2.0입니다.
이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.
객관 평가
AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.
- 지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가
- A양호freee-mcp를 통한 데이터 작업과 API 명세 제공이라는 역할을 명시합니다.
- 절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가
- A양호사업장 확인, 절차 예시와 명세 조회, API 호출까지 단계와 도구 이름을 제시합니다.
- 안전성전송·삭제·명령 실행 등을 명시하고 있는가
- B일부 부족사업장 일치 확인은 요구하지만 삭제 API 호출 전 확인 조건은 명시하지 않습니다.
- 도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가
- A양호연결과 인증 전제, SETUP.md 안내와 연결 모드 확인 방법을 제공합니다.
총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 19일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.
평가가 다르다고 생각되면 재검토를 요청하기
포함된 파일(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(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
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/dealshr- freee人事労務(従業員、勤怠など) 例:/api/v1/employeesinvoice- freee請求書(請求書、見積書、納品書) 例:/invoicespm- freee工数管理(プロジェクト、工数など) 例:/projectssm- freee販売(見積、受注、売上など) 例:/businessesit_management- freeeIT管理(メンバー、SaaSアカウント、アプリ、備品、部署、会社など) 例:/hub/it_management/membersfixed_asset_management- freee固定資産(固定資産の一覧、詳細、登録、更新、削除) 例:/hub/fixed_asset_management/fixed_assetspartner_management- freee業務委託管理(業務委託先の企業ユーザー・部門) 例:/hub/partner_management/orderer/company_userssurvey- freeeサーベイ(サーベイ企画、実施回)※ freee-mcp(リモート版) 限定 例:/hub/survey/base_surveyslaunch- freee開業(開業申請用データの参照・更新)※ freee-mcp(リモート版) 限定 例:/hub/launch/kaigyo_applicationemployee_evaluation- 人事評価(人事評価結果の取得)※ freee-mcp(リモート版) 限定 例:/hub/employee_evaluation/evaluation_resultstax_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 を参照してください。
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.