Agent Skill · 待分类

freee-api-skill（freee API 技能）

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。它适合让 Agent 梳理 endpoint、生成 OpenAPI 草稿、检查字段命名、整理错误码或辅助前后端联调。使用时需要确认真实业务语义、鉴权方式、分页和错误处理规则；涉及生成接口文档时，应避免凭空补字段，最好从现有代码、schema 或接口样例中提取事实。

freee-api-skill 是待分类类 Agent Skill，可用宿主为 Codex、Claude、Cursor、Gemini CLI，通过GitHub 仓库获取，权限为调用外部服务；许可证信息还不明确，第三方扫描有提醒项，按安装量在待分类类的 11,209 个 Skill 里排第 159。

总安装 39,984周安装 1,683GitHub Stars 423下载 14,008核验 2026-05-01

待分类调用外部服务 GitHub 仓库未标认证来源可访问许可证需确认审计提醒 Codex Claude Cursor Gemini CLI

安装说明

本站只整理中文说明，不托管安装包，也不代用户安装。

GitHub

许可证: unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：freee-api-skill（freee API 技能）
来源仓库：https://github.com/freee/freee-mcp
仓库路径：skills/freee-api-skill
安装命令：
npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills

npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill

这个 Skill 是做什么的

这个 Skill 的分类还没最终确定，用法以来源仓库的说明为准。

通过 MCP 免费访问会计、人力资源、发票、项目管理和销售 API，并提供详细的参考资料和操作指南。

提供用于 OAuth 身份验证、公司管理和五个服务 API 的 MCP 工具：会计（交易、费用）、HR（员工、出勤）、发票（发票、报价）、项目管理（项目、时间表）和销售（机会、订单）包括主要端点（交易、费用申请、员工、出勤、发票）的 API 参考文档，以及参数、请求正文和响应详细信息提供常见工作流程的配方指南：费用申请、交易注册、人力资源操作、出勤跟踪、发票、文件上传、项目时间表和销售管理需要通过 npx freee-mcp 配置进行初始 OAuth 设置在本地存储凭据；在调用 API 之前，公司 ID 必须与当前配置的业务匹配

来源仓库内路径：skills/freee-api-skill

上手步骤

4 步

1
确认自己的宿主工具
公开资料标注支持 Codex、Claude、Cursor、Gemini CLI；先确认自己用的是其中之一，再按对应工具的 Skills 目录放置。
2
拿到安装命令
可以直接复制的命令是 npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill；命令里的占位符换成自己的路径或密钥再执行。
3
安装后重启宿主
命令执行完要完全退出宿主工具再打开，让新装的 Skill 被重新扫描到，否则列表里可能看不到。
4
按最小权限试用
它需要调用外部服务，先在测试目录或测试账号里跑，确认没问题再放到正式项目。

常见问题

6 条

freee-api-skill 怎么安装？

在终端执行 npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill。装完完全退出宿主工具再打开，让它重新扫描本地 Skill。

freee-api-skill 支持哪些 AI 工具？

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录，一般也能手动放进去，但要自己确认触发方式是否一致。

freee-api-skill 需要什么权限？

权限级别是调用外部服务。该 Skill 可能调用第三方服务、云服务或外部模型 API，使用前需要确认账号、额度、数据发送范围和服务条款。

freee-api-skill 是免费的吗？

公开资料没有标注明确许可证，收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

freee-api-skill 用的人多吗？

公开数据是累计安装 39,984 次，近一周安装 1,683 次，下载 14,008 次，GitHub 423 星。这些数字来自第三方目录统计，只能当作热度参考，不代表质量或安全性。

freee-api-skill 安全吗？

第三方扫描有提醒项，说明存在需要人工确认的行为。安装前请打开源码看清它读了什么、联网到哪里。

值得选的地方和要先想清楚的地方

值得选的地方

同时适配 4 种工具，换客户端不用重新找替代品。

先想清楚的地方

许可证没有明确标注，能不能商用、能不能再分发都不确定。
第三方扫描存在提醒项或未通过项，需要人工逐条确认。
第三方目录整理，版本更新和行为细节以来源仓库为准。

适不适合你

更适合

已经在用 Codex，想直接扩展它能力的人。
需要处理待分类类任务、又不想每次都手写提示词的人。

不太适合

需要明确授权才能用到公司项目里的场景。
需要厂商级技术支持和 SLA 的生产系统。

待分类类 Skill 对比

6 个同类

Skill	总安装	GitHub 星	权限	许可证	扫描
infsh-cli infsh CLI · Codex、Claude	4,374,576	382	权限未标注	未明确	未收录
ai-video-generation AI 视频生成 · Codex、Claude	4,313,376	382	调用外部服务	未明确	有提醒
lark-openapi-explorer 云雀 OpenAPI 浏览器 · Codex、Claude	2,064,120	9,011	需要联网	未明确	有提醒
lark-workflow-standup-report Lark 工作流程站立报告 · Codex、Claude	2,041,632	8,978	需要联网	未明确	通过
use-my-browser 使用我的浏览器 · Codex、Claude	1,848,491	40	操作浏览器	未明确	未通过
freee-api-skill freee API 技能 · 本页	39,984	423	调用外部服务	未明确	有提醒

按安装量取同分类前几名；数字来自第三方目录统计，只作热度参考，不代表质量结论。

SKILL.md 原文

freee API スキル

概要

freee の会計・人事労務・請求書・工数管理・販売のデータを AI から直接操作できるスキルです。

freee-mcp (MCP サーバー) を通じて freee API と連携。

このスキルの役割:

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

接続方法は Remote MCP（推奨）とローカルの2つがあります。現在の接続モードは freee_server_info の transport フィールド（remote または stdio）で確認できます。

セットアップ

方法 1: Remote MCP で接続する（推奨）

freee が提供する Remote MCP サーバーに接続する方法です。ローカルでのセットアップが不要で、すぐに利用を開始できます。

Claude 及び Claude Desktop では「カスタマイズ」より「カスタムコネクタを追加」を開き、以下を設定してください。

名前: freee
URL: https://mcp.freee.co.jp/mcp

初回接続時にブラウザで freee への認証が自動的に行われます。npx freee-mcp configure の実行は不要です。

その他の AI ツールでは、それぞれの案内に従って Remote MCP サーバーを追加してください。

方法 2: ローカルで MCP サーバーを起動する

freee アプリケーションを自分で登録し、ローカルで MCP サーバーを起動する方法です。

npx freee-mcp configure

ブラウザで freee にログインし、事業所を選択します。設定は ~/.config/freee-mcp/config.json に保存されます。

Claude を再起動後、freee_auth_status ツールで認証状態を確認。

リファレンス

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

目的のAPIを探すには、references/ ディレクトリ内のファイルをキーワード検索してください。

主なリファレンス:

accounting-deals.md - 取引
accounting-expense-applications.md - 経費申請
hr-employees.md - 従業員情報
hr-attendances.md - 勤怠
invoice-invoices.md - 請求書

使い方

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パラメータ (必須):

service	説明	パス例
`accounting`	freee会計 (取引、勘定科目、取引先など)	`/api/1/deals`
`hr`	freee人事労務 (従業員、勤怠など)	`/api/v1/employees`
`invoice`	freee請求書 (請求書、見積書、納品書)	`/invoices`
`pm`	freee工数管理 (プロジェクト、工数など)	`/projects`
`sm`	freee販売 (見積、受注、売上など)	`/businesses`

基本ワークフロー

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

事業所を確認: freee_get_current_company で現在の事業所IDを取得する（初回は必須。セッション内で1回取得すれば以降は使い回せる）

- APIは事業所ごとにデータが分離されているため、正しい事業所を選択しないと意図しないデータにアクセスしてしまう

レシピを確認: recipes/ 内の該当レシピを読む

- よくある操作のパターンと注意点がまとまっているため、直接APIを叩くより効率的でミスが少ない

リファレンスを検索: 必要に応じて references/ を参照

- レシピにない詳細なパラメータやレスポンス仕様を確認する

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/report-operations.md - 試算表・総勘定元帳（レポート取得・未承認仕訳の確認）
recipes/freee-mcp-tag.md - メモタグ「freee-mcp」の付与ガイド

freee サイン（電子契約）

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

カラールール

freee のデータを表示・可視化する際は、以下の色を使用してページ全体の統一感を保つこと。

文字色: 見出し #1e46aa / 本文 #23418c / キャプション #323232 / リンク #00b9b9 #2864f0 #1e46aa / 強調 #dc1e32

背景色: メイン #285ac8 / 薄い #ebf3ff / ニュートラル #f7f5f5

アクセントカラー（多用しない）: イエロー #ffb91e / オレンジ #fa6414 / グリーン #82c31e / ティール #00b9b9

エラー対応

バージョン確認: 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
詳細: recipes/troubleshooting.md 参照

API の機能制限について

freee API 自体の機能制限に起因する問題は freee-mcp では解決できません。詳細は recipes/troubleshooting.md を参照してください。

平台分布

Codex

33.55%

按下载量换算4,700

Claude

31.68%

按下载量换算4,438

Cursor

18.09%

按下载量换算2,534

Gemini CLI

8.73%

按下载量换算1,223

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

可疑

权限和风险

调用外部服务

该 Skill 可能调用第三方服务、云服务或外部模型 API，使用前需要确认账号、额度、数据发送范围和服务条款。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在提醒或未通过项，安装前请自行复核。目前只有一个公开来源，建议同时核对源仓库。

继续浏览同类 Skills

更多待分类 Skills（11,209）返回 Skills 目录

上一个 Skill