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 の設定が必要。

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

This session only. Nothing lands on disk.

referencesaccounting-general-ledgers.md

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

General ledgers

総勘定元帳

GET /api/1/reports/general_ledgers — 総勘定元帳一覧の取得(β版)

概要 指定した事業所の総勘定元帳一覧を取得する ※このAPIはβ版として提供しています。 このAPIは法人アドバンスプラン(および旧法人プロフェッショナルプラン)・法人エンタープライズプランに加入している事業所のみが利用できます。 利用状況によって事前の告知なく提供プラン・コール数の上限を変更する可能性があります。 他エンドポイントと比べてレスポンスタイムが遅い場合があります。

パラメータ

  • company_id*: integer(int64) - 事業所ID

  • start_date*: string(date) - 期間で絞込:開始日 (yyyy-mm-dd)

  • end_date*: string(date) - 期間で絞込:終了日 (yyyy-mm-dd)

  • account_item_name: string - 勘定科目名で絞込

  • tax_name: string - 税区分名で絞込 (選択肢: 課税, 対象外, 非課税, 不課税, 輸出等, 未選択, 課税売上, 輸出売上, 非課売上, 非資売上, 有価譲渡, 対外売上, 課税売返, 輸出売返, 非課売返, 非資売返, 課税売倒, 輸出売倒, 非課売倒, 非資売倒, 課税売回, 課対輸本, 非対輸本, 共対輸本, 課対輸税, 非対輸税, 共対輸税, 地消貨割, 課対仕入, 非対仕入, 共対仕入, 非課仕入, 対外仕入, 課対仕返, 非対仕返, 共対仕返, 非課仕返, 課売上一, 課売上二, 課売上三, 課売上四, 課売上五, 課売上六, 課対輸返, 非対輸返, 共対輸返, 課売返一, 課売返二, 課売返三, 課売返四, 課売返五, 課売返六)

  • tax_rate: string - 税率で絞込 (選択肢: tax_rate_5, tax_rate_8, tax_rate_10, tax_rate_r8, tax_rate_5_exempt_80, tax_rate_5_exempt_70, tax_rate_5_exempt_50, tax_rate_5_exempt_30, tax_rate_8_exempt_80, tax_rate_8_exempt_70, tax_rate_8_exempt_50, tax_rate_8_exempt_30, tax_rate_10_exempt_80, tax_rate_10_exempt_70, tax_rate_10_exempt_50, tax_rate_10_exempt_30, tax_rate_r8_exempt_80, tax_rate_r8_exempt_70, tax_rate_r8_exempt_50, tax_rate_r8_exempt_30)

  • adjustment: string - 決算整理仕訳で絞込(決算整理仕訳のみ:only, 決算整理仕訳以外:without)。指定されない場合、決算整理仕訳を含む金額が返却されます。 (選択肢: only, without)

  • cost_allocation: string - 配賦仕訳で絞込(配賦仕訳のみ:only,配賦仕訳以外:without)。指定されない場合、配賦仕訳を含む金額が返却されます。 (選択肢: only, without)

  • partner_name: string - 取引先で絞込(未選択を指定すると、取引先が未選択で絞り込めます)

  • item_name: string - 品目で絞込(未選択を指定すると、品目が未選択で絞り込めます)

  • section_name: string - 部門で絞込(未選択を指定すると、部門が未選択で絞り込めます)

  • tag_name: string - メモタグで絞込

    取引数が多すぎる場合はタイムアウトする場合があります。

    その場合はWeb画面よりPDF/CSV出力をご利用ください。

  • segment_tag_1_name: string - セグメント1タグ名で絞込(未選択を指定すると、セグメント1タグが未選択で絞り込めます)

  • segment_tag_2_name: string - セグメント2タグ名で絞込(未選択を指定すると、セグメント2タグが未選択で絞り込めます)

  • segment_tag_3_name: string - セグメント3タグ名で絞込(未選択を指定すると、セグメント3タグが未選択で絞り込めます)

  • approval_flow_status: string - 承認ステータスで絞込 (未承認を除く: without_in_progress (デフォルト)、全てのステータス: all)

    事業所の設定から仕訳承認フローの利用を有効にした場合に指定可能です。 (選択肢: all, without_in_progress)

レスポンス

  • general_ledgers*: array[object]

Source: SKILL.md on GitHub

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

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
metadata
{
  "author": "freee_jp",
  "homepage": "https://github.com/freee/freee-mcp"
}
  • API
  • MCP
  • freee
  • accounting
  • hr
  • invoicing
  • project-management
  • expense-tracking
  • payroll

README badge

README badge for freee/freee-mcp

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.

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.