
Freee Api Skill
Guide correct freee accounting, HR, invoicing, and related API calls through freee-mcp with recipes and reference lookups.
Overview
freee-api-skill is an agent skill for the Build phase that maps freee accounting and business APIs to MCP tool sequences, recipes, and reference docs via freee-mcp.
Install
npx skills add https://github.com/freee/freee-mcp --skill freee-api-skillWhat is this skill?
- Covers freee accounting, HR, invoicing, project tracking, sales, and e-sign API surfaces
- Enforces freee_get_current_company before data calls and documents service/path parameters for freee_api_get
- Ships operation recipes (e.g. expense applications) and searchable API references for trial balance and reports
- Includes eval-style dry-run guidance: plan MCP calls without executing when testing agent behavior
- Pairs with freee-mcp and freee-sign-mcp for guided, parameter-accurate usage
- Skill version 0.29.0 with packaged eval dry-run scenarios for expense and trial-balance flows
Adoption & trust: 2k installs on skills.sh; 453 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need expense lists, trial balances, or other freee data through an agent but do not know the correct API path, company_id flow, or MCP call order.
Who is it for?
Solo builders and tiny teams using freee MCP servers to automate accounting or back-office reads and writes with explicit API guidance.
Skip if: Users without freee OAuth/MCP setup, or anyone needing generic international accounting APIs unrelated to freee.
When should I use this skill?
Integrating agent or app workflows with freee accounting, HR, invoicing, sales, or sign APIs through freee-mcp with accurate parameters.
What do I get? / Deliverables
The agent follows documented recipes and references to call freee_get_current_company then the right freee_api_get (or related MCP) parameters without guessing endpoints.
- Documented MCP call plan with service, path, and query/body parameters
- Recipe-aligned workflow for a specific freee operation (e.g. expenses, reports)
Recommended Skills
Journey fit
Connecting to freee is integration work you do while building automations, internal tools, or agent workflows that talk to live business APIs. The skill is entirely about API paths, company_id, MCP tool sequencing, and reference recipes—not UI polish or launch distribution.
How it compares
API recipe and reference pack for freee-mcp—not a standalone bookkeeping product or a non-Japanese ERP connector.
Common Questions / FAQ
Who is freee-api-skill for?
Developers and indie operators who already use or plan to use freee-mcp to query or update freee cloud services from coding agents.
When should I use freee-api-skill?
During Build integrations when you implement agent workflows for expenses, trial balances, invoices, HR, or sign APIs and need correct paths, parameters, and call order.
Is freee-api-skill safe to install?
Treat it as guidance around live financial APIs; review Prism’s Security Audits panel and never expose OAuth secrets in prompts or logs.
SKILL.md
READMESKILL.md - Freee Api Skill
name: freee-api-skill version: 0.29.0 description: freee の会計・人事労務・請求書・工数管理・販売・サイン(電子契約)API と連携するスキル。API リファレンスと操作レシピを提供し、freee-mcp / freee-sign-mcp 経由で正確な API 利用をガイドする。 { "skill_name": "freee-api-skill", "evals": [ { "id": 1, "prompt": "今月の経費申請を一覧で見せて\n\n注意: これはドライランです。実際にMCPツールは呼び出さず、どのツールをどのパラメータで呼び出すべきかを手順として説明してください。レシピやリファレンスの参照は実際に行ってください。", "expected_output": "recipes/expense-application-operations.md を参照した上で、freee_get_current_company → freee_api_get (service=accounting, path=/api/1/expense_applications) の手順を説明する。", "assertions": [ "freee_get_current_company を最初に呼び出す手順を説明している", "recipes/expense-application-operations.md を実際に参照している", "freee_api_get を service=accounting、path=/api/1/expense_applications で呼び出す計画を示している", "company_id パラメータが必要であることに言及している", "MCPツール(freee_api_get 等)を実際には呼び出していない" ] }, { "id": 2, "prompt": "先月の売上を勘定科目別に教えて\n\n注意: これはドライランです。実際にMCPツールは呼び出さず、どのツールをどのパラメータで呼び出すべきかを手順として説明してください。レシピやリファレンスの参照は実際に行ってください。", "expected_output": "references/ から試算表のリファレンスを検索・参照し、freee_get_current_company → freee_api_get (試算表API) の手順を説明する。", "assertions": [ "freee_get_current_company を最初に呼び出す手順を説明している", "references/ 内のリファレンスを実際に検索・参照している", "試算表関連のAPIパス(/api/1/reports/trial_pl 等)を使用する計画を示している", "未承認仕訳(approval_flow_status)についてユーザーに確認する手順を含んでいる", "期間パラメータ(start_date, end_date 等)に先月の日付を指定する計画を示している", "MCPツール(freee_api_get 等)を実際には呼び出していない" ] }, { "id": 3, "prompt": "freee に出勤を打刻して\n\n注意: これはドライランです。実際にMCPツールは呼び出さず、どのツールをどのパラメータで呼び出すべきかを手順として説明してください。レシピやリファレンスの参照は実際に行ってください。", "expected_output": "recipes/hr-attendance-operations.md を参照した上で、freee_get_current_company → freee_api_post (service=hr, 打刻API) の手順を説明する。", "assertions": [ "freee_get_current_company を最初に呼び出す手順を説明している", "recipes/ または references/ 内の勤怠関連ファイルを実際に参照している", "freee_api_post を service=hr で呼び出す計画を示している", "打刻タイプとして clock_in(出勤)を指定する計画を示している", "従業員IDの取得手順(/api/v1/users/me 等)を説明している", "打刻可能種別の事前確認(available_types)に言及している", "MCPツール(freee_api_post 等)を実際には呼び出していない" ] }, { "id": 4, "prompt": "取引先「テスト株式会社」に対して、税込11,000円の支出取引を登録したい。勘定科目は消耗品費で。\n\n注意: これはドライランです。実際にMCPツールは呼び出さず、どのツールをどのパラメータで呼び出すべきかを手順として説明してください。レシピやリファレンスの参照は実際に行ってください。", "expected_output": "recipes/deal-operations.md を参照し、freee_get_current_company → 取引先検索 → 勘定科目検索 → freee_api_post (path=/api/1/deals, type=expense) の手順を説明する。", "assertions": [ "freee_get_current_company を最初に呼び出す手順を説明している", "recipes/deal-operations.md を実際に参照している", "取引先を検索するAPI(/api/1/partners 等)を呼び出す手順を説明している", "勘定科目を検索するAPI(/api/1/account_items 等)を呼び出す手順を説明している", "freee_api_post を service=accounting、path=/api/1/deals で呼び出す計画を示している", "type を expense(支出)に設定する計画を示している", "MCPツール(freee_api_post 等)を実際には呼び出していない" ] }, { "id": 5, "prompt": "請求書を新しく作りたいんだけど、どうすればいい?\n\n注意: これはドライランです。実際にMCPツールは呼び出さず、どのツールをどのパラメータで呼び出すべきかを手順として説明してください。レシピやリファレンスの参照は実際に行ってください。", "expected_output": "recipes/invoice-operations.md を参照し、請求書作成の手順とパラメータを説明する。必要な情報(取引先、品目、金額等)をユーザーに確認する。", "assertions": [ "recipes/invoice-operations.md を実際に参照している", "請求書作成に必要なパラメータや手順を説明している", "請求書APIのパスとして /invoices(invoice サービス)を使用する計画を示している(会計APIの /api/1/invoices ではない)", "必要な情報をユーザーに確認している(取引先、品目、金額など)", "いきなりAPIを呼ぶ計画ではなく、まず情報を整理している", "MCPツールを実際には呼び出していない" ] }, { "id": 6, "prompt": "従業員の一覧を取得して\n\n注意: これはドライランです。実際にMCPツールは呼び出さず、どのツールをどのパラメータで呼び出すべきかを手順として説明してください。レシピやリファレンスの参照は実際に行ってください。", "expected_output": "freee_get_current_company → freee_api_get (service=hr, path=/api/v1/employees) の手順を説明する。", "assertions": [ "freee_get_current_company を最初に呼び出す手順を説明している", "freee_api_get を service=hr で呼び出す計画を示している",