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-references10800100.md

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

別表八（一）受取配当等の益金不算入に関する明細書

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

項目マッピング

帳票項番 項目名 xpath 型 区分値 / envelope
事業年度（自） - 元号 //HOB800[@page='1']/CBA00000/CBA00010/CBA00020 区分 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桁)
事業年度（至） - 元号 //HOB800[@page='1']/CBA00000/CBA00010/CBA00030 区分 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桁)
法人名 //HOB800[@page='1']/CBA00000/CBA00040 文字 envelope.NOZEISHA_NM
└ //IT/NOZEISHA_NM
1 完全子法人株式等に係る受取配当等の額 //HOB800[@page='1']/CBB00000/CBB00005 数値
2 関連法人株式等に係る受取配当等の額 //HOB800[@page='1']/CBB00000/CBB00010/CBB00020 数値
3 その他株式等に係る受取配当等の額 //HOB800[@page='1']/CBB00000/CBB00180 数値
4 非支配目的株式等に係る受取配当等の額 //HOB800[@page='1']/CBB00000/CBB00143 数値
5 受取配当等の益金不算入額 - 区分 //HOB800[@page='1']/CBB00000/CBB00147 区分
└ //HOB800[@page='1']/CBB00000/CBB00147/kubun_CD 1=20%, 2=40%
└ //HOB800[@page='1']/CBB00000/CBB00147/kubun_NM kubun_CDに対応する名称(最大30文字)
5 - 金額 //HOB800[@page='1']/CBB00000/CBB00150 数値
【繰り返しグループ】（繰り返しグループ ラッパー: 完全子法人株式等　明細） //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n] Array
6 └ 完全子法人株式等　明細 - 法人名 //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00030 文字
7 └ - 本店の所在地 //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00040 文字
8 └ - 受取配当等の額の計算期間(自)　元号 //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00060 区分
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00060/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00060/gen:yy 和暦年(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00060/gen:mm 月(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00060/gen:dd 日(2桁)
8 └ - 受取配当等の額の計算期間(至)　元号 //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00070 区分
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00070/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00070/gen:yy 和暦年(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00070/gen:mm 月(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00050/CBH00070/gen:dd 日(2桁)
9 └ - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00010/CBH00020[n]/CBH00080 数値
9 完全子法人株式等　計 - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00010/CBH00090 数値
【繰り返しグループ】（繰り返しグループ ラッパー: 関連法人株式等　明細） //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n] Array
10 └ 関連法人株式等　明細 - 法人名 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00120 文字
11 └ - 本店の所在地 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00130 文字
12 └ - 受取配当等の額の計算期間(自)　元号 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00150 区分
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00150/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00150/gen:yy 和暦年(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00150/gen:mm 月(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00150/gen:dd 日(2桁)
12 └ - 受取配当等の額の計算期間(至)　元号 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00160 区分
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00160/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00160/gen:yy 和暦年(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00160/gen:mm 月(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00140/CBH00160/gen:dd 日(2桁)
13 - 保有割合 //HOB800[@page='1']/CBH00170 文字
14 └ - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00180 数値
15 └ - 同上のうち益金の額に算入される金額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00190 数値
16 └ - 益金不算入の対象となる金額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00200 数値
17 └ - (34)が「不適用」の場合又は別表八(一)付表「13」が「非該当」の場合 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00210 数値
18 └ - (16)／(16の計) //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00220/CBH00230 数値
19 └ - 支払利子等の10％相当額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00220/CBH00240 数値
20 └ - 受取配当等の額から控除する支払利子等の額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00110[n]/CBH00250 数値
14 関連法人株式等　計 - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00260/CBH00270 数値
15 - 同上のうち益金の額に算入される金額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00260/CBH00280 数値
16 - 益金不算入の対象となる金額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00260/CBH00290 数値
17 - (34)が「不適用」の場合又は別表八(一)付表「13」が「非該当」の場合 //HOB800[@page='1']/CBH00000/CBH00100/CBH00260/CBH00300 数値
18 - (16)／(16の計) //HOB800[@page='1']/CBH00000/CBH00100/CBH00260/CBH00310/CBH00320 数値
19 - 支払利子等の10％相当額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00260/CBH00310/CBH00330 数値
20 - 受取配当等の額から控除する支払利子等の額 //HOB800[@page='1']/CBH00000/CBH00100/CBH00260/CBH00340 数値
【繰り返しグループ】（繰り返しグループ ラッパー: その他株式等　明細） //HOB800[@page='1']/CBH00000/CBH00350/CBH00360[n] Array
21 └ その他株式等　明細 - 法人名 //HOB800[@page='1']/CBH00000/CBH00350/CBH00360[n]/CBH00370 文字
22 └ - 本店の所在地 //HOB800[@page='1']/CBH00000/CBH00350/CBH00360[n]/CBH00380 文字
23 - 保有割合 //HOB800[@page='1']/CBH00390 文字
24 └ - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00350/CBH00360[n]/CBH00400 数値
25 └ - 同上のうち益金の額に算入される金額 //HOB800[@page='1']/CBH00000/CBH00350/CBH00360[n]/CBH00410 数値
26 └ - 益金不算入の対象となる金額 //HOB800[@page='1']/CBH00000/CBH00350/CBH00360[n]/CBH00420 数値
24 その他株式等　計 - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00350/CBH00430/CBH00440 数値
25 - 同上のうち益金の額に算入される金額 //HOB800[@page='1']/CBH00000/CBH00350/CBH00430/CBH00450 数値
26 - 益金不算入の対象となる金額 //HOB800[@page='1']/CBH00000/CBH00350/CBH00430/CBH00460 数値
【繰り返しグループ】（繰り返しグループ ラッパー: 非支配目的株式等　明細） //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n] Array
27 └ 非支配目的株式等　明細 - 法人名又は銘柄 //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00490 文字
28 └ - 本店の所在地 //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00500 文字
29 └ - 基準日等　元号 //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00510 区分
└ //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00510/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00510/gen:yy 和暦年(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00510/gen:mm 月(2桁)
└ //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00510/gen:dd 日(2桁)
30 - 保有割合 //HOB800[@page='1']/CBH00520 文字
31 └ - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00530 数値
32 └ - 同上のうち益金の額に算入される金額 //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00540 数値
33 └ - 益金不算入の対象となる金額 //HOB800[@page='1']/CBH00000/CBH00470/CBH00480[n]/CBH00550 数値
31 非支配目的株式等　計 - 受取配当等の額 //HOB800[@page='1']/CBH00000/CBH00470/CBH00560/CBH00570 数値
32 - 同上のうち益金の額に算入される金額 //HOB800[@page='1']/CBH00000/CBH00470/CBH00560/CBH00580 数値
33 - 益金不算入の対象となる金額 //HOB800[@page='1']/CBH00000/CBH00470/CBH00560/CBH00590 数値
34 支払利子等の額の明細 - 令第19条第２項の規定による支払利子控除額の計算 //HOB800[@page='1']/CBI00000/CBI00010 区分
└ //HOB800[@page='1']/CBI00000/CBI00010/kubun_CD 1=適用, 2=不適用
└ //HOB800[@page='1']/CBI00000/CBI00010/kubun_NM kubun_CDに対応する名称(最大30文字)
35 - 当期に支払う利子等の額 //HOB800[@page='1']/CBI00000/CBI00020 数値
36 - 国外支配株主等に係る負債の利子等の損金不算入額、対象純支払利子等の損金不算入額又は恒久的施設に帰せられるべき資本に対応する負債の利子の損金不算入額 //HOB800[@page='1']/CBI00000/CBI00030 数値
37 - 超過利子額の損金算入額 //HOB800[@page='1']/CBI00000/CBI00040 数値
38 - 支払利子等の額の合計額 //HOB800[@page='1']/CBI00000/CBI00050 数値
適用事業年度等 //HOB800[@page='1']/CBF00000 文字

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.