freee API 技能：集成 freee 会计/人事/发票 API 的 MCP 服务器使用指南

freee-api-skill by freee/freee-mcp

972 周安装量

356 GitHub Stars

GitHub

安装命令

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

开发自动化 API

🇨🇳中文介绍

freee API 技能

概述

通过 freee-mcp (MCP 服务器) 与 freee API 集成。

此技能的作用：

提供 freee API 的详细参考
提供 freee-mcp 使用指南和 API 调用示例

注意：OAuth 认证需要用户在自己的环境中执行。

设置

1. OAuth 认证（在您的终端中执行）

npx freee-mcp configure

在浏览器中登录 freee 并选择公司。配置将保存在 ~/.config/freee-mcp/config.json 中。

2. 重启并确认

重启 Claude 后，使用 freee_auth_status 工具检查认证状态。

参考

API 参考包含在 references/ 目录中。每个参考都包含参数、请求体和响应的详细信息。

要查找目标 API，请在 references/ 目录中的文件中进行关键词搜索。

主要参考：

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

733,500 周安装

Vercel React 最佳实践指南 | 58条Next.js性能优化规则与代码重构

252,100 周安装

Vercel Web界面规范检查工具 - 自动检测代码是否符合Web设计指南

202,600 周安装

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

133,200 周安装

accounting-deals.md - 交易
accounting-expense-applications.md - 费用申请
hr-employees.md - 员工信息
hr-attendances.md - 考勤
invoice-invoices.md - 发票

freee_authenticate - OAuth 认证
freee_auth_status - 检查认证状态
freee_clear_auth - 清除认证信息
freee_current_user - 获取登录用户信息
freee_list_companies - 公司列表
freee_set_current_company - 切换公司
freee_get_current_company - 获取当前公司

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`

确认公司：使用 freee_get_current_company 获取当前公司 ID（首次必需。在会话中获取一次后即可重复使用）
查看配方：阅读 recipes/ 目录中的相应配方
搜索参考：根据需要查阅 references/
调用 API：使用 freee_api_* 工具（对于需要 company_id 的端点，使用步骤 1 中获取的值）

recipes/expense-application-operations.md - 费用申请
recipes/deal-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 - 销售管理（项目/订单）

版本确认：首先阅读 VERSION.md 确认技能版本，并使用 freee_server_info 确认服务器版本。如果技能版本比服务器旧，则技能信息可能未与最新的服务器对应。请将技能更新到最新版本后再试。
认证错误：使用 freee_auth_status 确认 → freee_clear_auth → freee_authenticate
公司错误：freee_list_companies → freee_set_current_company
详细信息：请参阅 recipes/troubleshooting.md

🇺🇸English

freee API スキル

概要

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

このスキルの役割:

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

注意: OAuth 認証はユーザー自身が自分の環境で実行する必要があります。

セットアップ

1. OAuth 認証（あなたのターミナルで実行）

npx freee-mcp configure

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

2. 再起動して確認

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 認証
freee_auth_status - 認証状態確認
freee_clear_auth - 認証情報クリア
freee_current_user - ログインユーザー情報取得
freee_list_companies - 事業所一覧
freee_set_current_company - 事業所切り替え
freee_get_current_company - 現在の事業所取得

サーバー情報:

freee_server_info - サーバー情報取得（バージョンなど）

ファイル操作:

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_get_current_company で現在の事業所IDを取得する（初回は必須。セッション内で1回取得すれば以降は使い回せる）
レシピを確認: recipes/ 内の該当レシピを読む
リファレンスを検索: 必要に応じて references/ を参照
API を呼び出す: freee_api_* ツールを使用（company_id が必要なエンドポイントでは手順1で取得した値を使う）

注意:

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

レシピ

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

recipes/expense-application-operations.md - 経費申請
recipes/deal-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 - 販売管理（案件・受注）

エラー対応

バージョン確認: まず VERSION.md を読んでスキルのバージョンを確認し、freee_server_info でサーバーバージョンを確認してください。スキルのバージョンがサーバーより古い場合、スキルの情報が最新のサーバーに対応していない可能性があります。スキルを最新版に更新してから再度お試しください。
認証エラー: 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 を参照してください。

freee API 技能：集成 freee 会计/人事/发票 API 的 MCP 服务器使用指南

🇨🇳中文介绍

freee API 技能

概述

设置

1. OAuth 认证（在您的终端中执行）

2. 重启并确认

参考

相关 Skills

使用方法

MCP 工具

基本工作流程

配方

错误处理

关于 API 的功能限制

相关链接