DiscordSign up
SKILLS.SH

freee-api-skill

freee accounting, HR, invoicing, project management, and sales API access through MCP with detailed references and operation guides. Provides MCP tools for OAuth authentication, company management, and five service APIs: accounting (deals, expenses), HR (employees, attendance), invoicing (invoices, quotes), project management (projects, timesheets), and sales (opportunities, orders) Includes API reference documentation for major endpoints (deals, expense applications, employees, attendances, invoices) with parameters, request bodies, and response details Offers recipe guides for common workflows: expense applications, deal registration, HR operations, attendance tracking, invoicing, file uploads, project timesheets, and sales management Requires initial OAuth setup via npx freee-mcp configure to store credentials locally; company ID must match the currently configured business before making API calls

INSTALLATION
npx skills add https://github.com/freee/freee-mcp --skill freee-api-skill
Run in your project or agent environment. Adjust flags if your CLI version differs.

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 を参照してください。

関連リンク

  • Remote MCP サーバー: https://mcp.freee.co.jp/mcp
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Related skills

find-skills
2/3

Discover and install specialized agent skills from the open ecosystem when users need extended capabilities. Helps identify relevant skills by domain and task when users ask "how do I do X" or "find a skill for X" Integrates with the Skills CLI ( npx skills find , npx skills add ) to search, verify, and install packages from the skills.sh directory Recommends skills based on install count, source reputation, and GitHub stars to ensure quality before suggesting installation Presents skill options with install commands and links to skills.sh for user review and one-click installation

Verified authorvercel-labs
SKILLS.SH
1.5M19.6K
2026-05-22
vercel-react-best-practices
3/3

React and Next.js performance optimization guide with 64 prioritized rules across 8 categories. Organized by impact level, from critical waterfalls and bundle optimization down to advanced patterns, each rule includes incorrect/correct code examples and explanations Covers eight domains: async patterns, bundle size, server-side caching, client-side data fetching, re-render optimization, rendering performance, JavaScript efficiency, and advanced patterns Designed for use during component writing, code review, refactoring, and performance audits on React and Next.js applications Each rule has a prefix code (e.g., async-parallel , bundle-barrel-imports ) for easy reference in automated tooling and documentation

Verified authorvercel-labs
SKILLS.SH
389K26.9K
2026-05-22
azure-validate
2/3

Pre-deployment validation for Azure infrastructure, configuration, and permissions before deployment. Requires .azure/plan.md from a prior azure-prepare run; stops immediately if the plan is missing Executes recipe-specific validation commands (azd provision, bicep build, terraform validate) and records proof in the plan document Performs build verification, configuration checks, and permission validation; blocks deployment if any check fails Only authorized method to set plan status to Validated ; must be followed by azure-deploy skill to execute the actual deployment

Verified authormicrosoft
SKILLS.SH
324K1.1K
2026-05-22
appinsights-instrumentation
3/3

Guidance and reference material for instrumenting webapps with Azure Application Insights. Covers SDK setup, telemetry patterns, and configuration for ASP.NET Core and Node.js applications hosted in Azure Distinguishes between this skill (reference and guidance) and azure-prepare (actual implementation); invoke azure-prepare when the user wants to add instrumentation to their project Provides auto-instrumentation guidance for C# ASP.NET Core apps in Azure App Service, plus manual instrumentation paths for creating App Insights resources via Bicep templates or Azure CLI Includes language-specific code modification guides for ASP.NET Core, Node.js, and Python, plus quick references for OpenTelemetry SDKs and exporters

Verified authormicrosoft
SKILLS.SH
324K1.1K
2026-05-22

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card