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

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

第二十号様式 市町村民税の中間・確定申告書

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

項目マッピング

帳票項番 項目名 xpath 型 区分値 / envelope
［※処理事項］整理番号 //R0504AA211[@page='1']/AAA00100 文字
［※処理事項］事務所 //R0504AA211[@page='1']/AAA00200 文字
［※処理事項］管理（旧法人）番号 //R0504AA211[@page='1']/AAA00300 文字
［※処理事項］申告区分 //R0504AA211[@page='1']/AAA00400 区分 1=確定, 2=中間, 3=修正確定
法人番号 //R0504AA211[@page='1']/AAA00500 文字
申告年月日 //R0504AA211[@page='1']/AAA00700 日付
└ //R0504AA211[@page='1']/AAA00700/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAA00700/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAA00700/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAA00700/gen:dd 日(2桁)
提出年月日 //R0504AA211[@page='1']/AAA00800 日付
└ //R0504AA211[@page='1']/AAA00800/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAA00800/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAA00800/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAA00800/gen:dd 日(2桁)
あて先 //R0504AA211[@page='1']/AAA00900 文字
［本店］所在地郵便番号 //R0504AA211[@page='1']/AAA_HONTEN_ZIP 文字
［本店］所在地 //R0504AA211[@page='1']/AAA_HONTEN_ADDR 文字
［本店］電話 //R0504AA211[@page='1']/AAA_HONTEN_TEL_NUM 文字
［支店］所在地郵便番号 //R0504AA211[@page='1']/AAA_ZIP 文字
［支店］所在地 //R0504AA211[@page='1']/AAA_ADDR 文字
［支店］電話 //R0504AA211[@page='1']/AAA_TEL_NUM 文字
法人名フリガナ //R0504AA211[@page='1']/AAA_KANA 文字
法人名 //R0504AA211[@page='1']/AAA_NAME 文字
代表者氏名フリガナ //R0504AA211[@page='1']/AAA_DAIHYO_KANA 文字
代表者氏名 //R0504AA211[@page='1']/AAA_DAIHYO_NAME 文字
［この申告の基礎］法人税の修正申告年月日 //R0504AA211[@page='1']/AAA01000 日付
└ //R0504AA211[@page='1']/AAA01000/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAA01000/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAA01000/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAA01000/gen:dd 日(2桁)
└ //R0504AA211[@page='1']/AAA01000/gen:yyyymmdd 西暦日付(8桁)
［この申告の基礎］法人税の更正決定年月日 //R0504AA211[@page='1']/AAA01100 日付
└ //R0504AA211[@page='1']/AAA01100/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAA01100/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAA01100/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAA01100/gen:dd 日(2桁)
└ //R0504AA211[@page='1']/AAA01100/gen:yyyymmdd 西暦日付(8桁)
［この申告の基礎］法人税の申告の種類 //R0504AA211[@page='1']/AAA01200 区分 1=修正申告, 2=更正, 3=決定, 4=再更正
事業種目 //R0504AA211[@page='1']/AAA_JIGYO_NAME 文字
期末現在の資本金の額又は出資金の額 //R0504AA211[@page='1']/AAA_SHIHON 数値
法人税の期末現在の資本金等の額 //R0504AA211[@page='1']/AAA_SHIHON2 数値
期末現在の資本金の額及び資本準備金の額の合算額 //R0504AA211[@page='1']/AAA_SHIHON3 数値
期末現在の資本金等の額 //R0504AA211[@page='1']/AAA_SHIHON4 数値
経理責任者氏名フリガナ //R0504AA211[@page='1']/AAA_KEIRI_KANA 文字
経理責任者氏名 //R0504AA211[@page='1']/AAA_KEIRI_NAME 文字
事業年度開始年月日 //R0504AA211[@page='1']/AAA_JIGYO_SDATE 日付
└ //R0504AA211[@page='1']/AAA_JIGYO_SDATE/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAA_JIGYO_SDATE/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAA_JIGYO_SDATE/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAA_JIGYO_SDATE/gen:dd 日(2桁)
└ //R0504AA211[@page='1']/AAA_JIGYO_SDATE/gen:yyyymmdd 西暦日付(8桁)
事業年度終了年月日 //R0504AA211[@page='1']/AAA_JIGYO_EDATE 日付
└ //R0504AA211[@page='1']/AAA_JIGYO_EDATE/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAA_JIGYO_EDATE/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAA_JIGYO_EDATE/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAA_JIGYO_EDATE/gen:dd 日(2桁)
└ //R0504AA211[@page='1']/AAA_JIGYO_EDATE/gen:yyyymmdd 西暦日付(8桁)
申告の種類 //R0504AA211[@page='1']/AAA_RPT_KBN 文字
予備 //R0504AA211[@page='1']/AAA01300 文字
1 使途秘匿金税額等　（１） //R0504AA211[@page='1']/AAB00100 数値
1 法人税法の規定によって計算した法人税額　（１） //R0504AA211[@page='1']/AAB00110 数値
2 試験研究費の額等に係る法人税額の特別控除額　（２） //R0504AA211[@page='1']/AAB00200 数値
3 還付法人税額等の控除額　（３） //R0504AA211[@page='1']/AAB00400 数値
4 退職年金等積立金に係る法人税額　（４） //R0504AA211[@page='1']/AAB00500 数値
5 ［課税標準となる法人税額及びその法人税割額（１）＋（２）－（３）＋（４）］課税標準　（５） //R0504AA211[@page='1']/AAB00600 数値
5 ［課税標準となる法人税額及びその法人税割額（１）＋（２）－（３）＋（４）］税率　（５） //R0504AA211[@page='1']/AAB00610 数値
5 ［課税標準となる法人税額及びその法人税割額（１）＋（２）－（３）＋（４）］税額　（５） //R0504AA211[@page='1']/AAB00620 数値
6 ［２以上の市町村に事務所又は事業所を有する法人における課税標準となる法人税額及びその法人税割額（（５）／（２３）×（２４））］課税標準　（６） //R0504AA211[@page='1']/AAB00700 数値
6 ［２以上の市町村に事務所又は事業所を有する法人における課税標準となる法人税額及びその法人税割額（（５）／（２３）×（２４））］税率　（６） //R0504AA211[@page='1']/AAB00710 数値
6 ［２以上の市町村に事務所又は事業所を有する法人における課税標準となる法人税額及びその法人税割額（（５）／（２３）×（２４））］税額　（６） //R0504AA211[@page='1']/AAB00720 数値
7 市町村民税の特定寄附金税額控除額　（７） //R0504AA211[@page='1']/AAB00730 数値
8 税額控除超過額相当額の加算額　（８） //R0504AA211[@page='1']/AAB00740 数値
9 外国関係会社等に係る控除対象所得税額等相当額の控除額　（９） //R0504AA211[@page='1']/AAB00750 数値
10 外国の法人税等の額の控除額　（１０） //R0504AA211[@page='1']/AAB00800 数値
11 仮装経理に基づく法人税割額の控除額　（１１） //R0504AA211[@page='1']/AAB00900 数値
12 差引法人税割額（５）－（７）＋（８）－（９）－（１０）－（１１）又は（６）－（７）＋（８）－（９）－（１０）－（１１）　（１２） //R0504AA211[@page='1']/AAB01000 数値
13 既に納付の確定した当期分の法人税割額　（１３） //R0504AA211[@page='1']/AAB01100 数値
14 租税条約の実施に係る法人税割額の控除額　（１４） //R0504AA211[@page='1']/AAB01200 数値
15 この申告により納付すべき法人税割額（１２）－（１３）－（１４）　（１５） //R0504AA211[@page='1']/AAB01300 数値
16 ［均等割額］［算定期間中において事務所等を有していた月数］月　（１６） //R0504AA211[@page='1']/AAB01400 数値
［均等割額］［算定期間中において事務所等を有していた月数］円 //R0504AA211[@page='1']/AAB01410 数値
17 ［均等割額］［算定期間中において事務所等を有していた月数］［円×（１６）／１２］税額　（１７） //R0504AA211[@page='1']/AAB01420 数値
18 ［均等割額］［既に納付の確定した当期分の均等割額］税額　（１８） //R0504AA211[@page='1']/AAB01500 数値
19 ［均等割額］この申告により納付すべき均等割額（１７）－（１８）　（１９） //R0504AA211[@page='1']/AAB01600 数値
20 この申告により納付すべき市町村民税額（１５）＋（１９）　（２０） //R0504AA211[@page='1']/AAB01700 数値
21 （２０）のうち見込納付額　（２１） //R0504AA211[@page='1']/AAB01800 数値
22 ［差引（２０）－（２１）］税額　（２２） //R0504AA211[@page='1']/AAB01900 数値
【繰り返しグループ】当該市町村内に所在する事務所、事業所又は寮等 //R0504AA211[@page='1']/AAC00100[n] 繰り返し
［当該市町村内に所在する事務所、事業所又は寮等］名称 //R0504AA211[@page='1']/AAC00100[n]/AAC00200 文字
［当該市町村内に所在する事務所、事業所又は寮等］事務所、事業所又は寮等の所在地 //R0504AA211[@page='1']/AAC00100[n]/AAC00300 文字
［分割基準］左のうち当該市町村分の従業者数 //R0504AA211[@page='1']/AAC00100[n]/AAC00400 数値
当該市町村分の均等割の税率適用区分に用いる従業者数 //R0504AA211[@page='1']/AAC00100[n]/AAC00500 数値
23 ［合計］［分割基準］当該法人の全従業者数　（２３） //R0504AA211[@page='1']/AAC00600 数値
24 ［合計］［分割基準］左のうち当該市町村分の従業者数　（２４） //R0504AA211[@page='1']/AAC00700 数値
25 ［合計］当該市町村分の均等割の税率適用区分に用いる従業者数　（２５） //R0504AA211[@page='1']/AAC00800 数値
【繰り返しグループ】［指定都市に申告する場合の（１７）の計算］区 //R0504AA211[@page='1']/AAD00100[n] 繰り返し
［指定都市に申告する場合の（１７）の計算］区名 //R0504AA211[@page='1']/AAD00100[n]/AAD00200 文字
［指定都市に申告する場合の（１７）の計算］※区コード //R0504AA211[@page='1']/AAD00100[n]/AAD00300 kubun2 区コード(指定都市の行政区コード。列挙値ではなくマスタ参照)
［指定都市に申告する場合の（１７）の計算］月数 //R0504AA211[@page='1']/AAD00100[n]/AAD00400 数値
［指定都市に申告する場合の（１７）の計算］従業者数 //R0504AA211[@page='1']/AAD00100[n]/AAD00500 数値
［指定都市に申告する場合の（１７）の計算］均等割額 //R0504AA211[@page='1']/AAD00100[n]/AAD00600 数値
決算確定の日 //R0504AA211[@page='1']/AAE00100 日付
└ //R0504AA211[@page='1']/AAE00100/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAE00100/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAE00100/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAE00100/gen:dd 日(2桁)
解散の日 //R0504AA211[@page='1']/AAE01000 日付
└ //R0504AA211[@page='1']/AAE01000/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAE01000/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAE01000/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAE01000/gen:dd 日(2桁)
残余財産の最後の分配又は引渡しの日 //R0504AA211[@page='1']/AAE01100 日付
└ //R0504AA211[@page='1']/AAE01100/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAE01100/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAE01100/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAE01100/gen:dd 日(2桁)
法人税の申告書の種類 //R0504AA211[@page='1']/AAE00200 区分 1=青色, 2=その他
翌期の中間申告の要否 //R0504AA211[@page='1']/AAE00300 区分 1=要, 2=否
［この申告が中間申告の場合の計算期間］自 //R0504AA211[@page='1']/AAE00400 日付
└ //R0504AA211[@page='1']/AAE00400/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAE00400/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAE00400/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAE00400/gen:dd 日(2桁)
［この申告が中間申告の場合の計算期間］至 //R0504AA211[@page='1']/AAE00500 日付
└ //R0504AA211[@page='1']/AAE00500/gen:era 1=明治, 2=大正, 3=昭和, 4=平成, 5=令和
└ //R0504AA211[@page='1']/AAE00500/gen:yy 和暦年(2桁)
└ //R0504AA211[@page='1']/AAE00500/gen:mm 月(2桁)
└ //R0504AA211[@page='1']/AAE00500/gen:dd 日(2桁)
法人税の申告期限の延長の処分の有無 //R0504AA211[@page='1']/AAE00600 区分 1=有, 2=無
還付を受けようとする金融機関及び支払方法 //R0504AA211[@page='1']/AAE00700 文字
└ //R0504AA211[@page='1']/AAE00700/gen:kubun_CD 区分コード
└ //R0504AA211[@page='1']/AAE00700/gen:kinyukikan_NM 金融機関名
└ //R0504AA211[@page='1']/AAE00700/gen:shiten_NM 支店名
└ //R0504AA211[@page='1']/AAE00700/gen:kinyukikan_CD 金融機関コード(4桁)
└ //R0504AA211[@page='1']/AAE00700/gen:shiten_CD 支店コード(3桁)
└ //R0504AA211[@page='1']/AAE00700/gen:yokin 1=普通, 2=当座, 3=納税準備, 4=通知, 5=別段, 6=貯蓄, 9=その他
└ //R0504AA211[@page='1']/AAE00700/gen:koza 口座番号
還付請求税額 //R0504AA211[@page='1']/AAE00800 数値
法第１５条の４の徴収猶予を受けようとする税額 //R0504AA211[@page='1']/AAE00900 数値
関与税理士氏名 //R0504AA211[@page='1']/AAF_DAIRI_NAME 文字
［関与税理士氏名］電話 //R0504AA211[@page='1']/AAF_DAIRI_TEL_NUM 文字

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.