Live survey304 models · 14 providers · 23,592 auditsAudited implement · SAFE →What changedHow we verifyllms.txt

Agent skill · Audited from source

freee-api-skill

skill · freee/freee-mcpApache-2.0 licenceAudited 20 Oct 2026 · source 15ffed1ff182

★ 508pushed today
!CAUTIONGrade B · 89/100 · 2 findings · 15ffed1
508repo stars · whole freee/freee-mcp

Is it safe? With care — CAUTION, grade B (89/100). We read this skill's source at commit 15ffed1ff182 and found no filesystem, network or shell access and no hard-coded secrets. The audit raised 2 findings, 0 critical or high. What it does: freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告・サイン(電子契約)の詳細APIリファレンスと使い方ガイドを提供。freee…

Ask an AI about this pageGChatGPTCClaudePPerplexityGeGeminiXGrok
More
Cite

Cite this page

ModelsAtlas. “freee-api-skill (freee/freee-mcp)”. Retrieved 20 Oct 2026. https://modelsatlas.com/skills/freee/freee-api-skill

Trust audit

Audit 0.4.1 · source read 20 Oct 2026

Trust score89/100!CAUTION B
0 critical0 high2 medium0 low0 info

CAUTION means the audit found things worth knowing before you trust this skill. Grade B is shared by 17,406 of 18,389 audited skills.

What the source does

  • FilesystemNone observedNo reads or writes in the source
  • NetworkNone observedNo outbound calls in the source
  • ShellNone observedNo commands run in the source
  • DependenciesPinnedNothing floats
  • SecretsNone foundNo keys in source

Five audit layers

LayerWhat we checkResultFindings
L0 ProvenanceRepo owner, licence, archive status, activityWARN2
L1 Static sourceSecrets, path traversal, supply chain, hidden codeNA0
L2 InstructionsPrompt injection, authority framing, hidden directivesPASS0
L3 InventoryThe files and declarations match the sourcePASS0
L4 SandboxRun in isolation and watch behaviourSKIPPED why0

Gates applied: no behavioural pass.

Findings (2)

Audit 0.4.1 · source sha 15ffed1ff182 · 20 Oct 2026Report an issue or request a re-scan

Provenance

Who published it, and what the verdict is pinned to

  • Publisherfreee GitHub organizationOwner of the repository this skill is read from
  • Source folderfreee/freee-mcp/skills/freee-api-skillThe exact folder we audited
  • LicenceApache-2.0As the repository states it
  • Commit pinned for this verdict15ffed1ff182A new audit runs when the source changes
  • Repository statusNot archivedPushed today
  • Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

What it tells the agent

Full source on GitHub ↗

Its description: freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告・サイン(電子契約)の詳細APIリファレンスと使い方ガイドを提供。freee…

---
name: freee-api-skill
description: "freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告・サイン(電子契約)の詳細APIリファレンスと使い方ガイドを提供。freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・SaaSアカウント管理・備品管理・固定資産管理・業務委託先の企業ユーザー/部門管理・サーベイ企画/実施回の取得・開業申請用データの参照/更新・人事評価結果の取得・法人税申告データや帳票の参照・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、IT管理、固定資産管理、業務委託管理、サーベイ、開業、人事評価、申告、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。"
license: Apache-2.0
metadata:
  author: freee_jp
  homepage: https://github.com/freee/freee-mcp
---

# freee API スキル

## 概要

freee の会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告のデータを AI から直接操作できるスキルです。

[freee-mcp](https://www.npmjs.com/package/freee-mcp) (MCP サーバー) を通じて freee API と連携。

このスキルの役割:

- freee API の詳細リファレンスを提供
- freee-mcp 使用ガイドと API 呼び出し例を提供

## セットアップ

`freee_*` ツールが利用できている場合、セットアップは不要です。

以下のいずれかに該当する場合のみ `SETUP.md` を読み、ユーザーに接続手順を案内してください。

- `freee_*` ツールが1つも利用できない
- `freee_auth_status` が未認証を返し、「エラー対応」の手順でも解決しない
- ユーザーが接続方法・初期設定について質問している

接続モードは `freee_server_info` の transport フィールドで確認できます(`remote` = Remote MCP、`stdio` = ローカル)。

## リファレンス

API リファレンスが `references/` に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの情報があります。

目的の API を探す手順:

1. `references/INDEX.md` を読む(service ごとのファイル名と内容の一覧)
2. 索引で特定できない場合は `references/` 内のファイルをキーワード検索する

リファレンスの記法:

- `名前*` は必須、無印は任意
- 見出しの `### リクエストボディ*` はリクエストボディ自体が必須であることを示す
- パラメータは特記なき限り query。`(path)` `(header)` は該当箇所に明記
- パラメータ名末尾の `[]` はパラメータ名の一部であり API 呼び出し時に省略してはいけない
- `GET /xxx と同じ` は、同一ファイル内の該当エンドポイントと内容が同一であることを示す
- レスポンスはトップレベルの項目のみ記載。ネストした構造は実際に API を呼び出して確認する

法人税の帳票 XML(XTX / XBRL)の各要素と紙の帳票の項目との対応は
`tax-return-references/` にあります。索引と共通仕様は
`tax-return-references/index.md` にあり、帳票ごとのファイルは
その索引の帳票一覧から `sheet_code` で引きます(系列の別表や内訳書は
1 ファイルに複数帳票をまとめています)。

## 使い方

### MCP ツール

認証・事業所管理:

- `freee_authenticate` - OAuth 認証(Remote MCP では認証は自動処理されるため通常は不要)
- `freee_auth_status` - 認証状態確認
- `freee_clear_auth` - 認証情報クリア(ローカルモード用)
- `freee_current_user` - ログインユーザー情報取得
- `freee_list_companies` - 事業所一覧
- `freee_set_current_company` - 事業所切り替え
- `freee_get_current_company` - 現在の事業所取得

サーバー情報:

- `freee_server_info` - サーバー情報取得(バージョン、transport: remote/stdio)

ファイル操作:

- `freee_file_upload` - ファイルボックスにファイルをアップロード (POST /api/1/receipts) ※ローカルモードのみ

API 呼び出し:

- `freee_api_get` - GET リクエスト
- `freee_api_post` - POST リクエスト
- `freee_api_put` - PUT リクエスト
- `freee_api_delete` - DELETE リクエスト
- `freee_api_patch` - PATCH リクエスト
- `freee_api_list_paths` - 利用可能なAPIパス一覧

serviceパラメータ (必須):

- `accounting` - freee会計(取引、勘定科目、取引先など) 例: `/api/1/deals`
- `hr` - freee人事労務(従業員、勤怠など) 例: `/api/v1/employees`
- `invoice` - freee請求書(請求書、見積書、納品書) 例: `/invoices`
- `pm` - freee工数管理(プロジェクト、工数など) 例: `/projects`
- `sm` - freee販売(見積、受注、売上など) 例: `/businesses`
- `it_management` - freeeIT管理(メンバー、SaaSアカウント、アプリ、備品、部署、会社など) 例: `/hub/it_management/members`
- `fixed_asset_management` - freee固定資産(固定資産の一覧、詳細、登録、更新、削除) 例: `/hub/fixed_asset_management/fixed_assets`
- `partner_management` - freee業務委託管理(業務委託先の企業ユーザー・部門) 例: `/hub/partner_management/orderer/company_users`
- `survey` - freeeサーベイ(サーベイ企画、実施回)※ freee-mcp(リモート版) 限定 例: `/hub/survey/base_surveys`
- `launch` - freee開業(開業申請用データの参照・更新)※ freee-mcp(リモート版) 限定 例: `/hub/launch/kaigyo_application`
- `employee_evaluation` - 人事評価(人事評価結果の取得)※ freee-mcp(リモート版) 限定 例: `/hub/employee_evaluation/evaluation_results`
- `tax_return` - freee申告(法人税申告・帳票参照) 例: `/hub/tax_return/corporate`

### 基本ワークフロー

接続モードが不明な場合は `freee_server_info` で確認できます(transport が `remote` なら Remote MCP、`stdio` ならローカル)。Remote MCP の場合、認証は自動処理されるため手順1から開始できます。ローカルモードで未認証の場合は先に `freee_authenticate` を実行してください。

1. 事業所を確認: `freee_get_current_company` で現在の事業所IDを取得する(初回は必須。セッション内で1回取得すれば以降は使い回せる)
   - APIは事業所ごとにデータが分離されているため、正しい事業所を選択しないと意図しないデータにアクセスしてしまう
2. レシピを確認: `recipes/` 内の該当レシピを読む
   - よくある操作のパターンと注意点がまとまっているため、直接APIを叩くより効率的でミスが少ない
3. リファレンスを検索: 必要に応じて `references/INDEX.md` から該当ファイルを引く
   - レシピにない詳細なパラメータやレスポンス仕様を確認する
4. API を呼び出す: `freee_api_*` ツールを使用(company_id が必要なエンドポイントでは手順1で取得した値を使う)

注意:
- `company_id` は現在設定されている事業所と一致している必要がある。不一致の場合はエラーになる
- 事業所を変更する場合: 先に `freee_set_current_company` で切り替えてからリクエストを実行

### レシピ

よくある操作のユースケースサンプルとTipsは以下を参照:

- `recipes/expense-application-operations.md` - 経費申請
- `recipes/deal-operations.md` - 取引(収入・支出)
- `recipes/manual-journal-operations.md` - 振替伝票
- `recipes/payment-request-operations.md` - 支払依頼
- `recipes/hr-employee-operations.md` - 人事労務(従業員・給与)
- `recipes/hr-attendance-operations.md` - 勤怠(出退勤・打刻・休憩の登録)
- `recipes/invoice-operations.md` - 請求書・見積書・納品書
- `recipes/receipt-operations.md` - ファイルボックス(証憑ファイルのアップロード・管理)
- `recipes/pm-operations.md` - 工数管理(プロジェクト・工数実績)
- `recipes/pm-workload-registration.md` - 工数の安全な登録(PM・HR連携ワークフロー)
- `recipes/sm-operations.md` - 販売管理(案件・受注)
- `recipes/partner-management-operations.md` - 業務委託管理(パートナー・企業ユーザー・部門・プロジェクト・タスクの参照)
- `recipes/it-management-operations.md` - IT管理(メンバー・SaaSアカウント・アプリ・備品・部署・会社など)
- `recipes/survey-operations.md` - サーベイ(サーベイ企画・実施回の取得)
- `recipes/launch-operations.md` - 開業(開業申請用データの参照・更新)
- `recipes/fixed-asset-management-operations.md` - 固定資産管理(安全な更新・削除判断・Web画面への引き継ぎ)
- `recipes/corporate-tax-return-operations.md` - 申告(法人税申告・帳票の参照)
- `recipes/report-operations.md` - 試算表・総勘定元帳(レポート取得・未承認仕訳の確認)
- `recipes/freee-mcp-tag.md` - メモタグ「freee-mcp」の付与ガイド

## freee サイン(電子契約)

freee サインは別の MCP サーバー(`freee-sign-mcp`)で提供されます。
`sign_api_get` 等のサインツールが利用可能な場合は `SIGN-GUIDE.md` を参照してください。

## データの可視化

freee のデータをグラフ・表・HTML 等で可視化する場合は `COLORS.md` を読み、そこで指定された配色を使うこと。

## エラー対応

- バージョン確認: `VERSION.md` を読んでスキルのバージョンを確認し(ファイルが存在しない場合は開発版を使用中)、`freee_server_info` でサーバーバージョンを確認してください。スキルのバージョンがサーバーより古い場合、スキルの情報が最新のサーバーに対応していない可能性があります。スキルを最新版に更新してから再度お試しください。
- 認証エラー(Remote MCP): MCP クライアント(Claude Desktop 等)が自動的に再認証を促します。解決しない場合はカスタムコネクタを一度削除し、再度追加してください。
- 認証エラー(ローカル): `freee_auth_status` で確認 → `freee_clear_auth` → `freee_authenticate`
- 事業所エラー: `freee_list_companies` → `freee_set_current_company`
- 詳細

Excerpt, first 6,000 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

Install

Pinned to the audited commit 15ffed1

Download folder ↗
git clone https://github.com/freee/freee-mcp
git -C freee-mcp checkout 15ffed1ff182

The author documents no install command, so this uses the repository directly. Our verdict covers commit 15ffed1ff182 only.

Works in which agents?

What its own text says, not a test

AgentStatusMore
Claude DesktopMentioned in its text, not testedSkills for Claude Desktop · About Claude Desktop
“Mentioned” means the skill’s text names the agent. We have not run it there.

Audit history

Every audit, every source change

  1. !CAUTION B 89 / 100

    first audit · source 15ffed1ff182

README badge

For maintainers · shows the latest audit

ModelsAtlas: CAUTION BMODELSATLASCAUTION · B
[![ModelsAtlas: CAUTION B](https://modelsatlas.com/skills/freee/freee-api-skill/badge.svg)](https://modelsatlas.com/skills/freee/freee-api-skill/)

The badge shows our verdict and grade for this skill, and links back to this page. It changes when the audit does.

Similar skills

Add this badge to your README

[![ModelsAtlas: CAUTION B](https://modelsatlas.com/skills/freee/freee-api-skill/badge.svg)](https://modelsatlas.com/skills/freee/freee-api-skill/)

Questions about freee-api-skill

What does the freee-api-skill skill do?
Model Context Protocol (MCP) server for freee API integration
Is freee-api-skill safe to install?
With care. The audit graded it B (89/100) and found 2 things worth knowing before you trust this skill, listed below with the exact line each was found on.
What can freee-api-skill access on my machine?
The audit observed no filesystem, network or shell use at all in its source.
Which assistants does freee-api-skill work with?
Its documentation mentions claude-desktop. That is what the text claims, not a compatibility test we ran.
How current is this page?
The grade is for one exact copy of the source (15ffed1ff182), read on 2026-10-20. The repository is watched, and a new audit runs when it changes — this is the first audit.

Sources

Spotted something wrong? Report a correction · Methodology

Keep going in your AI

Opens with this page as the source. We add nothing else to the prompt.