/freee-api-skill

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

184 files
2 MB
Apache-2
Updated 3 weeks ago
GitHub
1 warning

Ask your Agent

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

This session only. Nothing lands on disk.

tax-return-references10603100.md

9.3 KB raw

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

別表六（二十四）特別試験研究費に係る法人税額の特別控除に関する明細書

sheet_code: 10603100
様式ID: HOB656
電子申告: e-Tax（国税）
取得API: GET /hub/tax_return/corporate/sheet/national/{tax_return_id}/10603100
レスポンス: XTX(XML)
xpath ルート: //HOB656[@page='1']
共通仕様（xpath 表記の規則・名前空間・共通ヘッダ）は index.md を参照。

項目マッピング

帳票項番	項目名	xpath	型	区分値 / envelope
	事業年度(自) - 元号	`//HOB656[@page='1']/UJA00000/UJA00010/UJA00020`	区分	`envelope.JIGYO_NENDO_FROM`
		└ `//IT/JIGYO_NENDO_FROM/gen:era`		1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
		└ `//IT/JIGYO_NENDO_FROM/gen:yy`		和暦年(2桁)
		└ `//IT/JIGYO_NENDO_FROM/gen:mm`		月(2桁)
		└ `//IT/JIGYO_NENDO_FROM/gen:dd`		日(2桁)
	事業年度(至) - 元号	`//HOB656[@page='1']/UJA00000/UJA00010/UJA00030`	区分	`envelope.JIGYO_NENDO_TO`
		└ `//IT/JIGYO_NENDO_TO/gen:era`		1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
		└ `//IT/JIGYO_NENDO_TO/gen:yy`		和暦年(2桁)
		└ `//IT/JIGYO_NENDO_TO/gen:mm`		月(2桁)
		└ `//IT/JIGYO_NENDO_TO/gen:dd`		日(2桁)
	法人名	`//HOB656[@page='1']/UJA00000/UJA00040`	文字	`envelope.NOZEISHA_NM`
		└ `//IT/NOZEISHA_NM`
1	期末現在の資本金の額又は出資金の額	`//HOB656[@page='1']/UJB00000/UJB00010`	数値
2	期末現在の常時使用する従業員の数	`//HOB656[@page='1']/UJB00000/UJB00020`	数値
3	適用可否	`//HOB656[@page='1']/UJB00000/UJB00030`	区分
		└ `//HOB656[@page='1']/UJB00000/UJB00030/kubun_CD`		1=可
		└ `//HOB656[@page='1']/UJB00000/UJB00030/kubun_NM`		kubun_CDに対応する名称(最大30文字)
4	雇用者給与等支給額	`//HOB656[@page='1']/UJC00000/UJC00010`	数値
5	比較雇用者給与等支給額	`//HOB656[@page='1']/UJC00000/UJC00020`	数値
6	雇用者給与等支給増加額	`//HOB656[@page='1']/UJC00000/UJC00030`	数値
7	雇用者給与等支給増加割合	`//HOB656[@page='1']/UJC00000/UJC00040`	数値
8	調整雇用者給与等支給増加額の計算 - 調整雇用者給与等支給額	`//HOB656[@page='1']/UJC00000/UJC00050/UJC00060`	数値
9	- 調整比較雇用者給与等支給額	`//HOB656[@page='1']/UJC00000/UJC00050/UJC00070`	数値
10	- 調整雇用者給与等支給増加額	`//HOB656[@page='1']/UJC00000/UJC00050/UJC00080`	数値
11	継続雇用者給与等支給増加割合の計算 - 継続雇用者給与等支給額	`//HOB656[@page='1']/UJC00000/UJC00090/UJC00100`	数値
12	- 継続雇用者比較給与等支給額	`//HOB656[@page='1']/UJC00000/UJC00090/UJC00110`	数値
13	- 継続雇用者給与等支給増加額	`//HOB656[@page='1']/UJC00000/UJC00090/UJC00120`	数値
14	- 継続雇用者給与等支給増加割合	`//HOB656[@page='1']/UJC00000/UJC00090/UJC00130`	数値
15	教育訓練費増加割合の計算 - 教育訓練費の額	`//HOB656[@page='1']/UJC00000/UJC00140/UJC00150`	数値
16	- 比較教育訓練費の額	`//HOB656[@page='1']/UJC00000/UJC00140/UJC00160`	数値
17	- 教育訓練費増加額	`//HOB656[@page='1']/UJC00000/UJC00140/UJC00170`	数値
18	- 教育訓練費増加割合	`//HOB656[@page='1']/UJC00000/UJC00140/UJC00180`	数値
19	雇用者給与等支給額比教育訓練費割合	`//HOB656[@page='1']/UJC00000/UJC00185`	数値
20	控除対象雇用者給与等支給増加額	`//HOB656[@page='1']/UJC00000/UJC00190`	数値
21	雇用者給与等支給増加重複控除額	`//HOB656[@page='1']/UJC00000/UJC00200`	数値
22	差引控除対象雇用者給与等支給増加額	`//HOB656[@page='1']/UJC00000/UJC00210`	数値
23	税額控除限度額等の計算　第１項適用の場合 - (14)＞＝４％の場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00380`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00380/kubun_CD`		1=0.05, 2=0.1, 3=0.15
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00380/kubun_NM`		kubun_CDに対応する名称(最大30文字)
24	- (18)＞＝10％又は(15)＝(17)＞０の場合で、かつ、(19)＞＝0.05％の場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00390`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00390/kubun_CD`		1=0.05
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00390/kubun_NM`		kubun_CDに対応する名称(最大30文字)
25	- プラチナくるみん又はプラチナえるぼしを取得している場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00400`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00400/kubun_CD`		1=0.05
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00400/kubun_NM`		kubun_CDに対応する名称(最大30文字)
26	- 税額控除限度額	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00370/UJC00410`	数値
27	税額控除限度額等の計算　第２項適用の場合 - (14)＞＝４％の場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00430`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00430/kubun_CD`		1=0.15
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00430/kubun_NM`		kubun_CDに対応する名称(最大30文字)
28	- (18)＞＝10％又は(15)＝(17)＞０の場合で、かつ、(19)＞＝0.05％の場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00440`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00440/kubun_CD`		1=0.05
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00440/kubun_NM`		kubun_CDに対応する名称(最大30文字)
29	- プラチナくるみん又はえるぼし３段階目以上を取得している場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00450`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00450/kubun_CD`		1=0.05
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00450/kubun_NM`		kubun_CDに対応する名称(最大30文字)
30	- 特定税額控除限度額	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00420/UJC00460`	数値
31	税額控除限度額等の計算　第３項適用の場合 - (7)＞＝2.5％の場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00480`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00480/kubun_CD`		1=0.15
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00480/kubun_NM`		kubun_CDに対応する名称(最大30文字)
32	- (18)＞＝５％又は(15)＝(17)＞０の場合で、かつ、(19)＞＝0.05％の場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00490`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00490/kubun_CD`		1=0.1
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00490/kubun_NM`		kubun_CDに対応する名称(最大30文字)
33	- くるみん又はえるぼし２段階目以上を取得している場合	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00500`	区分
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00500/kubun_CD`		1=0.05
		└ `//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00500/kubun_NM`		kubun_CDに対応する名称(最大30文字)
34	- 中小企業者等税額控除限度額	`//HOB656[@page='1']/UJC00000/UJC00220/UJC00360/UJC00470/UJC00510`	数値
35	調整前法人税額	`//HOB656[@page='1']/UJC00000/UJC00310`	数値
36	当期税額基準額	`//HOB656[@page='1']/UJC00000/UJC00320`	数値
37	当期税額控除可能額	`//HOB656[@page='1']/UJC00000/UJC00330`	数値
38	調整前法人税額超過構成額	`//HOB656[@page='1']/UJC00000/UJC00340`	数値
39	当期税額控除額	`//HOB656[@page='1']/UJC00000/UJC00520`	数値
40	前期繰越分 - 差引当期税額基準額残額	`//HOB656[@page='1']/UJC00000/UJC00530/UJC00540`	数値
41	- 繰越税額控除限度超過額	`//HOB656[@page='1']/UJC00000/UJC00530/UJC00550`	数値
42	- 同上のうち当期繰越税額控除可能額	`//HOB656[@page='1']/UJC00000/UJC00530/UJC00560`	数値
43	- 調整前法人税額超過構成額	`//HOB656[@page='1']/UJC00000/UJC00530/UJC00570`	数値
44	- 当期繰越税額控除額	`//HOB656[@page='1']/UJC00000/UJC00530/UJC00580`	数値
45	法人税額の特別控除額	`//HOB656[@page='1']/UJC00000/UJC00350`	数値
	適用事業年度等	`//HOB656[@page='1']/UJD00000`	文字

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

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.