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.

tax-return-references10700100.md

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

別表七（一）欠損金又は災害損失金の損金算入等に関する明細書

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

項目マッピング

帳票項番 項目名 xpath 型 区分値 / envelope
事業年度(自) - 元号 //HOB710[@page='1']/MCA00000/MCA00010/MCA00020 区分 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桁)
事業年度(至) - 元号 //HOB710[@page='1']/MCA00000/MCA00010/MCA00030 区分 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桁)
法人名 //HOB710[@page='1']/MCA00000/MCA00040 文字 envelope.NOZEISHA_NM
└ //IT/NOZEISHA_NM
1 控除前所得金額 //HOB710[@page='1']/MCB00000/MCB00002 数値
2 損金算入限度額 - 区分 //HOB710[@page='1']/MCB00000/MCB00004/MCB00007 区分
└ //HOB710[@page='1']/MCB00000/MCB00004/MCB00007/kubun_CD 1=50, 5=100
└ //HOB710[@page='1']/MCB00000/MCB00004/MCB00007/kubun_NM kubun_CDに対応する名称(最大30文字)
2 - 金額 //HOB710[@page='1']/MCB00000/MCB00004/MCB00008 数値
明細1 - 事業年度(自)　元号 //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00030 区分
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00030/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00030/gen:yy 和暦年(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00030/gen:mm 月(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00030/gen:dd 日(2桁)
- 事業年度(至)　元号 //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00040 区分
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00040/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00040/gen:yy 和暦年(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00040/gen:mm 月(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00020/MCB00040/gen:dd 日(2桁)
- 区分　青色欠損 //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00060 区分
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00060/kubun_CD 1=該当, 2=非該当
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00060/kubun_NM kubun_CDに対応する名称(最大30文字)
- 区分　連結みなし欠損 //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00070 区分
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00070/kubun_CD 1=該当, 2=非該当
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00070/kubun_NM kubun_CDに対応する名称(最大30文字)
- 区分　災害損失 //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00080 区分
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00080/kubun_CD 1=該当, 2=非該当
└ //HOB710[@page='1']/MCB00000/MCB00010/MCB00050/MCB00080/kubun_NM kubun_CDに対応する名称(最大30文字)
3 - 控除未済欠損金額 //HOB710[@page='1']/MCB00000/MCB00010/MCB00090 数値
4 - 当期控除額 //HOB710[@page='1']/MCB00000/MCB00010/MCB00100 数値
【繰り返しグループ】（繰り返しグループ ラッパー: 明細　繰り返し） //HOB710[@page='1']/MCB00000/MCB00110[n] Array
└ 明細　繰り返し - 事業年度(自)　元号 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00130 区分
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00130/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00130/gen:yy 和暦年(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00130/gen:mm 月(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00130/gen:dd 日(2桁)
└ - 事業年度(至)　元号 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00140 区分
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00140/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00140/gen:yy 和暦年(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00140/gen:mm 月(2桁)
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00120/MCB00140/gen:dd 日(2桁)
└ - 区分　青色欠損 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00160 区分
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00160/kubun_CD 1=該当, 2=非該当
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00160/kubun_NM kubun_CDに対応する名称(最大30文字)
└ - 区分　連結みなし欠損 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00170 区分
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00170/kubun_CD 1=該当, 2=非該当
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00170/kubun_NM kubun_CDに対応する名称(最大30文字)
└ - 区分　災害損失 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00180 区分
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00180/kubun_CD 1=該当, 2=非該当
└ //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00150/MCB00180/kubun_NM kubun_CDに対応する名称(最大30文字)
3 └ - 控除未済欠損金額 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00190 数値
4 └ - 当期控除額 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00200 数値
5 └ - 翌期繰越額 //HOB710[@page='1']/MCB00000/MCB00110[n]/MCB00210 数値
3 計 - 控除未済欠損金額 //HOB710[@page='1']/MCB00000/MCB00220/MCB00230 数値
4 - 当期控除額 //HOB710[@page='1']/MCB00000/MCB00220/MCB00240 数値
5 - 翌期繰越額 //HOB710[@page='1']/MCB00000/MCB00220/MCB00250 数値
3 当期分　欠損金額 - 控除未済欠損金額 //HOB710[@page='1']/MCB00000/MCB00260/MCB00270 数値
3 当期分　災害損失欠損金額 - 控除未済欠損金額 //HOB710[@page='1']/MCB00000/MCB00260/MCB00280/MCB00290/MCB00300 数値
4 - 欠損金の繰戻し額 //HOB710[@page='1']/MCB00000/MCB00260/MCB00280/MCB00290/MCB00315 数値
5 - 翌期繰越額 //HOB710[@page='1']/MCB00000/MCB00260/MCB00280/MCB00290/MCB00320 数値
3 当期分　青色欠損金額 - 控除未済欠損金額 //HOB710[@page='1']/MCB00000/MCB00260/MCB00280/MCB00330/MCB00340 数値
4 - 欠損金の繰戻し額 //HOB710[@page='1']/MCB00000/MCB00260/MCB00280/MCB00330/MCB00350 数値
5 - 翌期繰越額 //HOB710[@page='1']/MCB00000/MCB00260/MCB00280/MCB00330/MCB00360 数値
5 合計 - 翌期繰越額 //HOB710[@page='1']/MCB00000/MCB00370 数値
災害の種類 //HOB710[@page='1']/MCC00000/MCC00010 文字
災害のやんだ日又はやむを得ない事情のやんだ日 - 元号 //HOB710[@page='1']/MCC00000/MCC00020 区分
└ //HOB710[@page='1']/MCC00000/MCC00020/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB710[@page='1']/MCC00000/MCC00020/gen:yy 和暦年(2桁)
└ //HOB710[@page='1']/MCC00000/MCC00020/gen:mm 月(2桁)
└ //HOB710[@page='1']/MCC00000/MCC00020/gen:dd 日(2桁)
6 当期の欠損金額 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00040 数値
7 災害により生じた損失の額　資産の滅失等により生じた損失の額 - 棚卸資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00060/MCC00070/MCC00090 数値
7 - 固定資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00060/MCC00100/MCC00120 数値
7 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00060/MCC00130/MCC00150 数値
8 災害により生じた損失の額　被害資産の原状回復のための費用等に係る損失の額 - 棚卸資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00160/MCC00170/MCC00190 数値
8 - 固定資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00160/MCC00200/MCC00220 数値
8 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00160/MCC00230/MCC00250 数値
9 災害により生じた損失の額　被害の拡大又は発生の防止のための費用に係る損失の額 - 棚卸資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00252/MCC00254 数値
9 - 固定資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00252/MCC00256 数値
9 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00252/MCC00258 数値
10 災害により生じた損失の額　計 - 棚卸資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00260/MCC00270/MCC00290 数値
10 - 固定資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00260/MCC00300/MCC00320 数値
10 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00050/MCC00260/MCC00330/MCC00350 数値
11 保険金又は損害賠償金等の額 - 棚卸資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00360/MCC00370/MCC00390 数値
11 - 固定資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00360/MCC00400/MCC00420 数値
11 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00360/MCC00430/MCC00450 数値
12 差引災害により生じた損失の額 - 棚卸資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00460/MCC00470/MCC00490 数値
12 - 固定資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00460/MCC00500/MCC00520 数値
12 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00460/MCC00530/MCC00550 数値
13 同上のうち所得税額の還付又は欠損金の繰戻しの対象となる災害損失金額 - 棚卸資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00590/MCC00600 数値
13 - 固定資産 //HOB710[@page='1']/MCC00000/MCC00030/MCC00590/MCC00610 数値
13 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00590/MCC00620 数値
14 中間申告における災害損失欠損金の繰戻し額 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00630 数値
15 繰戻しの対象となる災害損失欠損金額 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00640 数値
16 繰越控除の対象となる欠損金額 - 計 //HOB710[@page='1']/MCC00000/MCC00030/MCC00560/MCC00580 数値
適用事業年度等 //HOB710[@page='1']/MCD00000 文字

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.