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

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

別表十四（二）寄附金の損金算入に関する明細書

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

項目マッピング

帳票項番 項目名 xpath 型 区分値 / envelope
事業年度（自） - 元号 //HOE099[@page='1']/WWA00000/WWA00010/WWA00020 区分 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桁)
事業年度（至） - 元号 //HOE099[@page='1']/WWA00000/WWA00010/WWA00030 区分 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桁)
法人名 //HOE099[@page='1']/WWA00000/WWA00040 文字 envelope.NOZEISHA_NM
└ //IT/NOZEISHA_NM
1 公益法人等以外の法人の場合 - 指定寄附金等の金額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00020/WWB00030 数値
2 - 特定公益増進法人等に対する寄附金額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00020/WWB00040 数値
3 - その他の寄附金額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00020/WWB00050 数値
4 - 計（4） //HOE099[@page='1']/WWB00000/WWB00010/WWB00020/WWB00060 数値
5 - 完全支配関係がある法人に対する寄附金額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00020/WWB00070 数値
6 - 計（6） //HOE099[@page='1']/WWB00000/WWB00010/WWB00020/WWB00080 数値
7 - 所得金額仮計 //HOE099[@page='1']/WWB00000/WWB00010/WWB00090 数値
8 - 寄附金支出前所得金額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00100 数値
9 - 同上の2.5又は1.25／100相当額　区分 //HOE099[@page='1']/WWB00000/WWB00010/WWB00105 区分
└ //HOE099[@page='1']/WWB00000/WWB00010/WWB00105/kubun_CD 1=2.5(／100), 2=1.25(／100)
└ //HOE099[@page='1']/WWB00000/WWB00010/WWB00105/kubun_NM kubun_CDに対応する名称(最大30文字)
9 - 同上の2.5又は1.25／100相当額　金額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00110 数値
10 - 期末の資本金の額及び資本準備金の額の合計額又は出資金の額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00120 数値
11 - 同上の月数換算額　月数 //HOE099[@page='1']/WWB00000/WWB00010/WWB00130/WWB00140 数値
11 - 同上の月数換算額　金額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00130/WWB00150 数値
12 - 同上の2.5／1,000相当額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00160 数値
13 - 一般寄附金の損金算入限度額 //HOE099[@page='1']/WWB00000/WWB00010/WWB00170 数値
14 - 寄附金支出前所得金額の6.25／100相当額 //HOE099[@page='1']/WWB00000/WWB00180/WWB00190 数値
15 - 期末の資本金の額及び資本準備金の額の合計額又は出資金の額の月数換算額の3.75／1,000相当額 //HOE099[@page='1']/WWB00000/WWB00180/WWB00200 数値
16 - 特定公益増進法人等に対する寄附金の特別損金算入限度額 //HOE099[@page='1']/WWB00000/WWB00180/WWB00210 数値
17 - 特定公益増進法人等に対する寄附金の損金算入額 //HOE099[@page='1']/WWB00000/WWB00220 数値
18 - 指定寄附金等の金額 //HOE099[@page='1']/WWB00000/WWB00230 数値
19 - 国外関連者に対する寄附金額及び本店等に対する内部寄附金額 //HOE099[@page='1']/WWB00000/WWB00240 数値
20 - （4）の寄附金額のうち同上の寄附金以外の寄附金額 //HOE099[@page='1']/WWB00000/WWB00250 数値
21 - 同上のうち損金の額に算入されない金額 //HOE099[@page='1']/WWB00000/WWB00260/WWB00270 数値
22 - 国外関連者に対する寄附金額及び本店等に対する内部寄附金額 //HOE099[@page='1']/WWB00000/WWB00260/WWB00280 数値
23 - 完全支配関係がある法人に対する寄附金額 //HOE099[@page='1']/WWB00000/WWB00260/WWB00290 数値
24 - 損金不算入額　計 //HOE099[@page='1']/WWB00000/WWB00260/WWB00300 数値
25 公益法人等の場合 - 長期給付事業への繰入利子額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00020/WWC00030 数値
26 - 同上以外のみなし寄附金額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00020/WWC00040 数値
27 - その他の寄附金額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00020/WWC00050 数値
28 - 支出した寄附金の額　計 //HOE099[@page='1']/WWC00000/WWC00010/WWC00020/WWC00060 数値
29 - 所得金額仮計 //HOE099[@page='1']/WWC00000/WWC00010/WWC00070 数値
30 - 寄附金支出前所得金額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00080 数値
31 - 同上の20又は50／100相当額　区分 //HOE099[@page='1']/WWC00000/WWC00010/WWC00090/WWC00100 区分
└ //HOE099[@page='1']/WWC00000/WWC00010/WWC00090/WWC00100/kubun_CD 1=20(／100), 2=50(／100)
└ //HOE099[@page='1']/WWC00000/WWC00010/WWC00090/WWC00100/kubun_NM kubun_CDに対応する名称(最大30文字)
31 - 同上の20又は50／100相当額　金額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00090/WWC00110 数値
32 - 公益社団法人又は公益財団法人の公益法人特別限度額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00120 数値
33 - 長期給付事業を行う共済組合等の損金算入限度額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00130 数値
34 - 損金算入限度額 //HOE099[@page='1']/WWC00000/WWC00010/WWC00140 数値
35 - 指定寄附金等の金額 //HOE099[@page='1']/WWC00000/WWC00150 数値
36 - 国外関連者に対する寄附金額及び完全支配関係がある法人に対する寄附金額 //HOE099[@page='1']/WWC00000/WWC00160 数値
37 - （28）の寄附金額のうち同上の寄附金以外の寄附金額 //HOE099[@page='1']/WWC00000/WWC00170 数値
38 - 同上のうち損金の額に算入されない金額 //HOE099[@page='1']/WWC00000/WWC00180/WWC00190 数値
39 - 国外関連者に対する寄附金額及び完全支配関係がある法人に対する寄附金額 //HOE099[@page='1']/WWC00000/WWC00180/WWC00200 数値
40 - 損金不算入額　計 //HOE099[@page='1']/WWC00000/WWC00180/WWC00210 数値
【繰り返しグループ】（繰り返しグループ ラッパー: 指定寄附金等に関する明細） //HOE099[@page='1']/WWD00000/WWD00010[n] Array
└ 指定寄附金等に関する明細 - 寄附した日　元号 //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00020 区分
└ //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00020/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00020/gen:yy 和暦年(2桁)
└ //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00020/gen:mm 月(2桁)
└ //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00020/gen:dd 日(2桁)
└ - 寄附先 //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00030 文字
└ - 告示番号 //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00040 文字
└ - 寄附金の使途 //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00050 文字
41 └ - 寄附金額 //HOE099[@page='1']/WWD00000/WWD00010[n]/WWD00060 数値
41 - 寄附金額　計 //HOE099[@page='1']/WWD00000/WWD00070 数値
【繰り返しグループ】（繰り返しグループ ラッパー: 特定公益増進法人若しくは認定特定非営利活動法人等に対する寄附金又は認定特定公益信託に対する支出金の明細） //HOE099[@page='1']/WWE00000/WWE00010[n] Array
└ 特定公益増進法人若しくは認定特定非営利活動法人等に対する寄附金又は認定特定公益信託に対する支出金の明細 - 寄附した日又は支出した日　元号 //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00020 区分
└ //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00020/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00020/gen:yy 和暦年(2桁)
└ //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00020/gen:mm 月(2桁)
└ //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00020/gen:dd 日(2桁)
└ - 寄附先又は受託者 //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00030 文字
└ - 所在地 //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00040 文字
└ - 寄附金の使途又は認定特定公益信託の名称 //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00050 文字
42 └ - 寄附金額又は支出金額 //HOE099[@page='1']/WWE00000/WWE00010[n]/WWE00060 数値
42 - 寄附金額又は支出金額　計 //HOE099[@page='1']/WWE00000/WWE00070 数値
【繰り返しグループ】（繰り返しグループ ラッパー: その他の寄附金のうち特定公益信託（認定特定公益信託を除く。）に対する支出金の明細） //HOE099[@page='1']/WWF00000/WWF00010[n] Array
└ その他の寄附金のうち特定公益信託（認定特定公益信託を除く。）に対する支出金の明細 - 支出した日　元号 //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00020 区分
└ //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00020/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00020/gen:yy 和暦年(2桁)
└ //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00020/gen:mm 月(2桁)
└ //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00020/gen:dd 日(2桁)
└ - 受託者 //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00030 文字
└ - 所在地 //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00040 文字
└ - 特定公益信託の名称 //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00050 文字
└ - 支出金額 //HOE099[@page='1']/WWF00000/WWF00010[n]/WWF00060 数値
適用事業年度等 //HOE099[@page='1']/WWG00000 文字

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.