PluginBench
Skill
Review
Audit score 70

freee-api-skill

freee/freee-mcp

Access freee accounting, HR, invoicing, project management, and sales APIs with detailed reference guides and recipes.

SourceView on skills.sh

What is freee-api-skill?

This skill provides comprehensive API reference documentation and usage guides for freee's cloud business software suite, including accounting, HR/payroll, invoicing, project management, sales, and IT management. Use it when you need to query or manipulate freee data, integrate with freee workflows, or understand API specifications for these business domains.

  • Query and manipulate freee accounting data (deals, expense applications, journal entries, trial balance)
  • Manage HR and payroll operations (employees, attendance, salary slips, payroll)
  • Create and manage invoices, quotes, and delivery notes
  • Track project time and resource allocation via project management APIs
  • Manage sales operations (quotations, orders, revenue)
  • Administer IT management features (SaaS accounts, equipment, team members)

How to install freee-api-skill

npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill
Prerequisites
  • freee account with appropriate permissions for your use case
  • For Remote MCP (recommended): Add custom connector at https://mcp.freee.co.jp/mcp in Claude/Claude Desktop
  • For local mode: Run `npx freee-mcp configure` and authenticate via browser
Claude Code
Cursor
Windsurf
Cline

How to use freee-api-skill

  1. 1.Confirm your current business location using `freee_get_current_company` (required once per session)
  2. 2.Review the relevant recipe in `recipes/` directory for your use case (e.g., `recipes/deal-operations.md` for transactions)
  3. 3.Search `references/` directory for detailed API specifications if needed (e.g., `accounting-deals.md`)
  4. 4.Call the appropriate `freee_api_*` tool (GET, POST, PUT, PATCH, DELETE) with the correct service parameter and endpoint
  5. 5.Switch business locations if needed using `freee_set_current_company` before making requests to a different company

Use cases

Good for
  • Retrieve and create expense applications with automatic categorization
  • Register business transactions and reconcile accounting records
  • Query employee attendance records and generate payroll reports
  • Generate invoices and track payment status across projects
  • Register project time entries and manage workload allocation
Who it's for
  • Accountants and bookkeepers managing freee accounting
  • HR and payroll administrators
  • Project managers tracking time and resources
  • Sales and business operations teams
  • Finance teams generating reports and reconciliations

freee-api-skill FAQ

What's the difference between Remote MCP and local mode?

Remote MCP (recommended) connects to freee's hosted server at https://mcp.freee.co.jp/mcp with automatic authentication—no local setup needed. Local mode requires running `npx freee-mcp configure` on your machine. Check current mode with `freee_server_info` (transport field shows 'remote' or 'stdio').

Do I need to authenticate every time?

No. Remote MCP handles authentication automatically on first connection. Local mode requires one-time setup via `freee_authenticate`. Use `freee_auth_status` to check authentication state.

How do I know which API endpoint to use?

Start with recipes in `recipes/` for common workflows (e.g., `recipes/expense-application-operations.md`). For detailed specifications, search `references/` by operation type (e.g., `accounting-deals.md` for transactions). Use `freee_api_list_paths` to see available endpoints.

What if I get a company_id mismatch error?

The company_id must match your current business location. Use `freee_list_companies` to see available companies, then `freee_set_current_company` to switch before making API calls.

Is freee Sign (electronic contracts) included?

No, freee Sign uses a separate MCP server (`freee-sign-mcp`). If sign tools are available, refer to `SIGN-GUIDE.md` for usage.

Full instructions (SKILL.md)

Source of truth, from freee/freee-mcp.

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 (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
it_managementfreeeIT管理 (SaaSアカウント、備品、メンバー)/hub/it_management/members

基本ワークフロー

接続モードが不明な場合は 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/it-management-operations.md - IT管理（メンバー・SaaSアカウント・備品）
  • 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 を参照してください。

関連リンク

Related skills

More from freee/freee-mcp and the wider catalog.

GPgpt-image-2-style-library logo

gpt-image-2-style-library

freestylefly/awesome-gpt-image-2

Choose GPT-Image2 / gpt-image-2 visual styles and industrial prompt templates from the awesome-gpt-image-2 style library. Use when an agent needs to create, rewrite, classify, or improve image-generation prompts with repository-backed templates, categories, style tags, scene tags, pitfalls, and example cases.

759 installsAudited
MAmanga-drama logo

manga-drama

freestylefly/canghe-skills

漫剧生成器 - 基于 Seedance 的漫画风格短剧生成工具。支持以主角图片为基础，自动生成漫剧分镜脚本并生成视频。适用于创作漫画风格的短视频、角色故事、动画短片等。当用户想要生成漫画风格的视频短剧、角色故事或漫剧时使用此技能。

700 installsAudited
WEwechat-article-extractor logo

wechat-article-extractor

freestylefly/wechat-article-extractor-skill

Extract metadata and content from WeChat Official Account articles via URL parsing.

3.5k installs
XIxiaohongshu-cover-generator logo

xiaohongshu-cover-generator

freestylefly/xiaohongshu-skills

Generate Xiaohongshu-style cover images from topics using AI.

1.6k installs
AFaframe-webxr logo

aframe-webxr

freshtechbro/claudedesignskills

Declarative web framework for building browser-based 3D, VR, and AR experiences using HTML and entity-component architecture. Use this skill when creating WebXR applications, VR experiences, AR experiences, 360-degree media viewers, or immersive web content with minimal JavaScript. Triggers on tasks involving A-Frame, WebXR, VR development, AR development, entity-component-system, declarative 3D, or HTML-based 3D scenes. Built on Three.js with accessible HTML-first approach.

993 installs
ANanimated-component-libraries logo

animated-component-libraries

freshtechbro/claudedesignskills

Pre-built animated React component collections combining Magic UI (150+ TypeScript/Tailwind/Motion components) and React Bits (90+ minimal-dependency animated components). Use this skill when building landing pages, marketing sites, dashboards, or interactive UIs requiring pre-made animated components instead of hand-crafting animations. Triggers on tasks involving animated UI components, Magic UI, React Bits, shadcn/ui integration, Tailwind CSS components, or component library selection. Alternative to manually implementing animations with Framer Motion or GSAP.

1.3k installs