skilld
All skills
freee avatar

/freee-api-skill

@f5d1212
by freeefreee/freee-mcp503 stars
58

freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告・サイン（電子契約）の詳細APIリファレンスと使い方ガイドを提供。freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・SaaSアカウント管理・備品管理・固定資産管理・業務委託先の企業ユーザー/部門管理・サーベイ企画/実施回の取得・開業申請用データの参照/更新・人事評価結果の取得・法人税申告データや帳票の参照・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、IT管理、固定資産管理、業務委託管理、サーベイ、開業、人事評価、申告、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。

Ask your Agent

Use this Skill: https://skilld.dev/gh/freee/freee-mcp/freee-api-skill

This session only. Nothing lands on disk.

referencesINDEX.md

≈1.8k tokens on demand. Your agent reads this file only when SKILL.md points to it.

API リファレンス索引

freee_api_* ツールの service ごとに、references/ 内の各リファレンスを 「ファイル名 — 内容」の形式で列挙する。 目的の API が分かっている場合はここからファイルを特定し、分からない場合は references/ 全体をキーワード検索する。

このファイルは scripts/generate-references.ts が自動生成する（手編集しないこと）。

accounting - freee会計

  • accounting-account-groups.md — 決算書表示名
  • accounting-account-items.md — 勘定科目
  • accounting-approval-flow-routes.md — 申請経路
  • accounting-approval-requests.md — 各種申請
  • accounting-banks.md — 連携サービス
  • accounting-companies.md — 事業所
  • accounting-deals.md — 取引（収入・支出）
  • accounting-expense-application-currencies.md — 経費精算の外貨
  • accounting-expense-application-forms.md — Expense application forms
  • accounting-expense-application-line-templates.md — 経費科目
  • accounting-expense-applications.md — 経費精算
  • accounting-fixed-assets.md — 固定資産台帳
  • accounting-general-ledgers.md — 総勘定元帳
  • accounting-invoices.md — 請求書
  • accounting-items.md — 品目
  • accounting-journals.md — 仕訳帳
  • accounting-manual-journals.md — 振替伝票
  • accounting-partners.md — 取引先
  • accounting-payment-requests.md — 支払依頼
  • accounting-payments.md — 取引（収入・支出）の支払行
  • accounting-purchase-requests.md — 購買申請
  • accounting-quotations.md — 見積書
  • accounting-receipts.md — ファイルボックス（証憑ファイル）
  • accounting-renews.md — 取引（収入・支出）の+更新
  • accounting-sections.md — 部門
  • accounting-segment-tags.md — セグメントタグ
  • accounting-selectables.md — フォーム用選択項目情報
  • accounting-tags.md — メモタグ
  • accounting-taxes.md — 税区分
  • accounting-transfers.md — 取引（振替）
  • accounting-trial-balance.md — 試算表
  • accounting-user-matchers.md — 自動登録ルール
  • accounting-users.md — ユーザー
  • accounting-wallet-txns.md — 口座明細
  • accounting-walletables.md — 口座

hr - freee人事労務

  • hr-approval-flow-routes.md — 申請経路の操作
  • hr-attendance-summaries.md — 勤怠情報の月次サマリの操作
  • hr-attendances.md — 勤怠の操作
  • hr-bonus-statements.md — 賞与明細の操作
  • hr-employee-bank-accounts.md — 従業員の銀行口座の操作
  • hr-employee-base-pay.md — 従業員の基本給の操作
  • hr-employee-custom-fields.md — 従業員のカスタム項目の操作
  • hr-employee-dependents.md — 従業員の家族情報の操作
  • hr-employee-health-insurance.md — 従業員の健康保険の操作
  • hr-employee-pension-insurance.md — 従業員の厚生年金保険の操作
  • hr-employee-profiles.md — 従業員の姓名・住所などの操作
  • hr-employee-special-leaves.md — 従業員の特別休暇の操作
  • hr-employees.md — 従業員の操作
  • hr-groups.md — 所属の操作
  • hr-login-user.md — ログインユーザーの取得
  • hr-monthly-attendance-closing-requests.md — 月次勤怠締め申請の操作
  • hr-overtime-requests.md — 残業申請の操作
  • hr-paid-holiday-requests.md — 有給申請
  • hr-paid-leave-requests.md — 有給休暇申請の操作
  • hr-payroll-statements.md — 給与明細の操作
  • hr-positions.md — 役職の操作
  • hr-sections.md — 部門の操作
  • hr-special-holiday-requests.md — 特別休暇申請の操作
  • hr-time-clocks.md — タイムレコーダー(打刻)機能の操作
  • hr-work-record-summaries.md — 勤怠タグサマリの操作
  • hr-work-record-tags.md — 勤怠タグの操作
  • hr-work-time-correction-requests.md — 勤務時間修正申請の操作
  • hr-year-end-adjustments.md — 年末調整の操作

invoice - freee請求書

  • invoice-delivery-slips.md — 納品書
  • invoice-invoices.md — 請求書
  • invoice-payment-notices.md — 支払通知書
  • invoice-purchase-orders.md — 発注書
  • invoice-quotations.md — 見積書
  • invoice-receipts.md — 領収書

pm - freee工数管理

  • pm-labor-budgets.md — LaborBudgets
  • pm-partners.md — Partners
  • pm-people.md — People
  • pm-project-tag-groups.md — ProjectTagGroups
  • pm-projects.md — Projects
  • pm-sales-order-statuses.md — SalesOrderStatuses
  • pm-teams.md — Teams
  • pm-unit-costs.md — UnitCosts
  • pm-users.md — ログインユーザー
  • pm-workload-tag-groups.md — WorkloadTagGroups
  • pm-workloads.md — Workloads

sm - freee販売

  • sm-advance-receipts.md — 前受金
  • sm-businesses.md — 案件
  • sm-cost-budgets.md — 原価予算
  • sm-deliveries.md — 納品
  • sm-master.md — 関連マスタ
  • sm-other-costs.md — その他原価
  • sm-periodic-sales.md — 定期売上
  • sm-procurements.md — 仕入
  • sm-purchase-orders.md — 発注
  • sm-quotations.md — 見積
  • sm-sales-orders.md — 受注
  • sm-sales-schedules.md — 売上予定
  • sm-sales.md — 売上

it_management - freeeIT管理

  • it-management-application-account.md — application_accounts
  • it-management-asset-categories.md — asset_categories
  • it-management-asset-statuses.md — asset_statuses
  • it-management-assets.md — assets
  • it-management-departments.md — departments
  • it-management-members.md — members

fixed_asset_management - freee固定資産

  • fixed-asset-management-fixed-assets.md — fixed_assets

partner_management - freee業務委託管理

  • partner-management-orderer-company-users.md — partner_management_orderer_company_users
  • partner-management-orderer-sections.md — partner_management_orderer_sections
  • partner-management-partner-management-orderer-partners.md — partner_management_orderer_partners
  • partner-management-partner-management-orderer-project-business-partners.md — partner_management_orderer_project_business_partners
  • partner-management-partner-management-orderer-project-company-users.md — partner_management_orderer_project_company_users
  • partner-management-partner-management-orderer-project-partners.md — partner_management_orderer_project_partners
  • partner-management-partner-management-orderer-projects.md — partner_management_orderer_projects
  • partner-management-partner-management-orderer-task-delivery-data-custom-fields.md — partner_management_orderer_task_delivery_data_custom_fields
  • partner-management-partner-management-orderer-task-line-items-custom-fields.md — partner_management_orderer_task_line_items_custom_fields
  • partner-management-partner-management-orderer-task-line-items.md — partner_management_orderer_task_line_items
  • partner-management-partner-management-orderer-tasks.md — partner_management_orderer_tasks

survey - freeeサーベイ

  • survey-surveys.md — ⚠ freee-mcp（リモート版） 限定 / survey

launch - freee開業

  • launch-kaigyo-application.md — ⚠ freee-mcp（リモート版） 限定 / launch_kaigyo_application

employee_evaluation - 人事評価

  • employee-evaluation-evaluation-results.md — ⚠ freee-mcp（リモート版） 限定 / employee_evaluation

tax_return - freee申告

  • tax-return-corporate.md — tax_return_corporate

Source: SKILL.md on GitHub

Third-party checks

1 warningtoday5 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides a comprehensive interface for AI agents to interact with the freee suite of APIs (Accounting, HR, Invoices, IT Management, etc.) via the Model Context Protocol (MCP). It includes exhaustive documentation, usage recipes, and security-conscious guidelines that instruct the agent to treat all retrieved financial and tax data as information rather than executable commands.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: MEDIUM · 1 issue

  • Runlayer6mo

    3/83 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at f5d1212. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated 3 weeks ago

Capability

metadata
{
  "author": "freee_jp",
  "homepage": "https://github.com/freee/freee-mcp"
}

Topics

  • API
  • MCP
  • freee
  • accounting
  • hr
  • invoicing
  • project-management
  • expense-tracking
  • payroll

README badge

README badge for freee/freee-mcp

What it does

Provides detailed API reference and usage guides for freee's accounting, HR, invoicing, project management, sales, and IT management services through the freee-mcp MCP server. Use this skill when you need to query or perform operations on freee data like expense reports, transactions, employee records, timesheets, invoices, or project hours.

Generated from the current SKILL.md.

Frequently asked

Does this skill work with both Remote MCP and local setup?
Yes. The skill supports Remote MCP (recommended, auto-authenticated via browser) and local MCP server setup (requires running `npx freee-mcp configure`). Use `freee_server_info` to check which transport mode is active.
Which freee products does this skill cover?
The skill covers accounting, HR/payroll, invoicing, project time tracking, sales management, IT management, and expense applications. Signing (electronic contracts) requires a separate `freee-sign-mcp` setup.
Do I need to specify a company ID for API calls?
Yes. You must first fetch the current company ID using `freee_get_current_company`, and it must match the company you want to operate on. Use `freee_set_current_company` to switch between companies before making API calls.
What should I do if I get an authentication error?
For Remote MCP, the client will prompt for re-authentication; if that fails, remove and re-add the custom connector. For local mode, use `freee_auth_status` to check status, then run `freee_clear_auth` followed by `freee_authenticate`.
Where do I find API details and usage examples?
The skill includes `recipes/` for common workflows (expense applications, deals, payroll, invoicing, etc.) and `references/` with detailed API parameters and response specs. Start with relevant recipes before consulting references.

Generated from the current SKILL.md. These answers refresh after source changes.