freee-api-skill

freee-mcp / freee-sign-mcp と連携するスキル。会計・人事労務・請求書・工数管理・販売・サイン（電子契約）の詳細APIリファレンスと使い方ガイドを提供。freee の経費申請・取引登録・勤怠打刻・給与明細・見積書・試算表・仕訳・従業員管理・工数登録・売上管理・電子契約の文書管理などの操作やAPI仕様を調べたいときに使う。ユーザーが freee のデータ操作、会計処理、人事労務管理、請求・見積、プロジェクト工数管理、販売管理、電子契約について質問や操作を依頼してきた場合は、明示的に freee と言及していなくても、このスキルの利用を検討すること。サインは別途 freee-sign-mcp の設定が必要。

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "freee-api-skill" with this command: npx skills add freee/freee-mcp/freee-freee-mcp-freee-api-skill

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説明パス例
accountingfreee会計 (取引、勘定科目、取引先など)/api/1/deals
hrfreee人事労務 (従業員、勤怠など)/api/v1/employees
invoicefreee請求書 (請求書、見積書、納品書)/invoices
pmfreee工数管理 (プロジェクト、工数など)/projects
smfreee販売 (見積、受注、売上など)/businesses

基本ワークフロー

接続モードが不明な場合は 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/ を参照
    • レシピにない詳細なパラメータやレスポンス仕様を確認する
  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/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 を参照してください。

関連リンク

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open in GitHubOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

RedotPay Payment Skill for MPP

Use this skill when the user wants to call an API, discover available services, or access external data with automatic payments using RedotPay — or mentions...

Registry SourceRecently Updated
00turbo-wang
General

Founder Signal

Founder Signal turns verified Reddit evidence into a small, reviewable signal package for founders evaluating product demand and positioning across one or mo...

Registry SourceRecently Updated
400toliuweijing
General

PM周报数据同步

将项目经理提交的原始 Excel 周报数据同步到乐荐飞书表格。当项目经理发送周报 Excel 文件、要求更新周收入数据、核对周报数据时激活。

Registry SourceRecently Updated
330romicboy
General

Bybit Exchange AI Trading Skill

Bybit Exchange Trading Skill — trade on Bybit using natural language. Covers spot, derivatives, earn, and more. Requires Bybit API credentials and explicit c...

Registry SourceRecently Updated
880victorwu-bybit