MCP-сервер Freee | PlugMCP
К содержанию freee-mcp
freee会計、人事労務、請求書、工数管理、販売、IT管理、固定資産、業務委託管理、サーベイ、開業、人事評価、申告、サイン（電子契約）を AI Agent から操作できるようにする freee 公式の MCP サーバーと Agent Skills です。
MCP サーバー: freee API の呼び出し・認証・リクエスト検証を担当
Agent Skills: API リファレンスと操作レシピを AI Agent のコンテキストに注入し、正確な API 利用をガイド
特徴
Model Context Protocol (MCP) server for freee API integration
Подключайте любой инструмент к любому агенту. Каталог MCP для тех, кто не пишет серверы.
Продукт
Каталог
Разработчикам
Компания
2026-11-15
Звёзды —
Инструменты —
Аптайм —
複数 API 対応: 会計・人事労務・請求書・工数管理・販売・IT管理・固定資産・業務委託管理・サーベイ・開業・人事評価・申告の12個の freee API をサポート
対応操作数: 587 操作（サイン（電子契約）含む、scripts/generate-references.ts が自動更新）
利用条件: サーベイ・開業・人事評価・申告は、対応する接続環境、OAuth クライアント、契約プラン、利用者権限が必要
サイン（電子契約）対応: freee サインの文書管理 API を専用コマンド（freee-sign-mcp）でサポート
OAuth 2.0 + PKCE: セキュアな認証フロー、トークン自動更新
複数事業所対応: 事業所の動的切り替えが可能
Agent Skills と MCP の通信の流れ Agent Skills（API リファレンス・操作レシピ）と MCP サーバー（API 呼び出し）を組み合わせて利用します。
sequenceDiagram
participant User as ユーザー
participant Agent as AI Agent
participant Skill as Agent Skills<br/>(API リファレンス・操作レシピ)
participant MCP as MCP サーバー
participant API as freee API
User->>Agent: リクエスト<br/>「取引一覧を取得して」
Note over Agent,Skill: 1. Agent Skills からリファレンスを取得
Agent->>Skill: freee-api-skill 呼び出し
Skill-->>Agent: API リファレンス注入<br/>(エンドポイント、パラメータ仕様)
Note over Agent,MCP: 2. MCP Tool で API を実行
Agent->>MCP: freee_api_get 呼び出し<br/>path: /api/1/deals
MCP->>MCP: OpenAPI スキーマで検証
MCP->>MCP: 認証トークン付与
Note over MCP,API: 3. freee API への通信
MCP->>API: GET /api/1/deals<br/>Authorization: Bearer xxx
API-->>MCP: JSON レスポンス
MCP-->>Agent: 取引データ
Agent-->>User: 結果を整形して表示
Agent Skills: 必要な API リファレンスや操作レシピを段階的にコンテキストに注入（コンテキスト効率化）
MCP: 認証・リクエスト検証・API 呼び出しを担当
クイックスタート
方法 1: Remote MCP で接続する（推奨） freee が提供する Remote MCP サーバーに接続する方法です。ローカルでのセットアップが不要で、すぐに利用を開始できます。
Claude 及び Claude Desktop では「カスタマイズ」より「カスタムコネクタを追加」を開き、以下を設定してください。
名前: freee
URL: https://mcp.freee.co.jp/mcp
⚠️ freee 公式以外の URL を入力しないようにご注意ください。
その他の AI ツールでは、それぞれの案内に従って Remote MCP サーバーを追加してください。
方法 2: ローカルで MCP サーバーを起動する freee アプリケーションを自分で登録し、ローカルで MCP サーバーを起動する方法です。手順は「ローカル MCP を使う場合 」をご覧ください。
Agent Skills をインストールする Claude 及び Claude Desktop では「カスタマイズ」より「スキル」を開き、最新の freee-api-skill.zip をダウンロードしてアップロードしてください。
Claude Code 等のコーディングエージェント（Cursor, OpenCode など）では、skills でインストールできます。
npx skills add freee/freee-mcp
グローバルインストール(-g)や特定スキルのみのインストール(-s)も可能です。
GitHub CLI（v2.90.0 以降）の gh skill
gh skill install freee/freee-mcp freee-api-skill
--agent（例: claude-code, copilot, cursor, codex, gemini-cli）や --scope user／--scope project の指定、--pin による特定タグ/コミットへの固定にも対応しています。
Agent Package Manager (APM) を利用している場合は、以下のコマンドでもインストールできます。GitHub Copilot / Claude Code / Cursor / OpenCode / Codex など、プロジェクトに存在する対象ディレクトリに自動でデプロイされます。
apm install freee/freee-mcp/skills/freee-api-skill
Claude Code Plugin として使う Claude Code でプラグインとしてインストールすると、Remote MCP サーバー freee（https://mcp.freee.co.jp/mcp）と Agent Skills（API リファレンス・操作レシピ）がまとめて利用できます。ローカルでのセットアップは不要です。
claude plugin marketplace add freee/freee-mcp
claude plugin install freee-mcp@freee-mcp-marketplace
Claude Code のプロンプト内からも実行できます:
/plugin marketplace add freee/freee-mcp
/plugin install freee-mcp@freee-mcp-marketplace
インストール後、/mcp で freee サーバーを選び、ブラウザで freee にログインして認証してください。
プラグインにはローカルの MCP サーバー（freee-mcp、freee-sign-mcp）は含まれません。freee サイン（電子契約）を使う場合や、自分で登録した freee アプリケーションで接続する場合は「ローカル MCP を使う場合 」をご覧ください。
Codex Plugin として使う OpenAI Codex のプラグインマーケットプレース（公式ドキュメント ）にも対応しており、MCP サーバーと Agent Skills（API リファレンス・操作レシピ）をまとめて利用できます。
Codex CLI からマーケットプレースを追加します:
codex plugin marketplace add freee/freee-mcp
その後 Codex を起動し、/plugins スラッシュコマンドでプラグイン一覧を開き、freee-mcp を選択して Install plugin を実行してください。
プラグイン定義は .codex-plugin/plugin.json、マーケットプレースカタログは .agents/plugins/marketplace.json にあります。
Agent Skills の内容 AI Agent との会話中に freee API の操作を依頼すると、これらのリファレンスやレシピを参照して正確に実行します。
データ作成のベストプラクティス 請求書や経費精算など、同じ形式のデータを繰り返し作成する場合は、以前に作成したデータを参照することで効率的に作業できます：
請求書作成: 過去の請求書を取得して、取引先・品目・税区分などを参考にする
経費精算: 過去の申請を参照して、勘定科目や部門の指定を正確に行う
取引登録: 類似の取引を参考にして、入力ミスを防ぐ
例: 「先月の○○社への請求書を参考に、今月分を作成して」
利用可能なツール
管理ツール
API ツール パスは OpenAPI スキーマに対して自動検証されます。
freee サイン（電子契約） freee サインの API は専用コマンド freee-sign-mcp で利用できます。
Remote MCP での提供は現在準備中です。ローカルでの MCP サーバー起動のみサポートしています。
サイン用ツール
company_id の取り扱い リクエスト（パラメータまたはボディ）に company_id を含める場合、現在の事業所と一致している必要があります。不一致の場合はエラーになります。
事業所の確認: freee_get_current_company
事業所の切り替え: freee_set_current_company
company_id を含まない API（例: /api/1/companies）はそのまま実行可能
ローカル MCP を使う場合 自分で登録した freee アプリケーションの認証情報を使い、MCP サーバーを手元で起動する方法です（stdio）。freee サイン（電子契約）は Remote MCP で提供していないため、サインを使う場合もこちらの手順で freee-sign-mcp を設定します。
ローカルモードでは、一部のエンドポイント（freee-mcp リモート版限定）は利用できません。
freee-mcp
1. freee アプリケーションの登録
コールバックURL: http://127.0.0.1:54321/callback
Client ID と Client Secret を取得
必要な権限にチェック
2. セットアップ 対話式ウィザードが認証情報の設定、OAuth認証、事業所選択を行います。
3. Claude Desktop に追加 configure が出力する設定を Claude Desktop の設定ファイルに追加:
{
"mcpServers": {
"freee": {
"command": "npx",
"args": ["freee-mcp"]
}
}
}
Windows Store (Microsoft Store) 版の Claude Desktop をご利用の場合、設定ファイルのパスが異なります。freee-mcp configure は自動的に適切なパスを検出します。
その他の MCP クライアントでは、同じ command と args をそれぞれの MCP 設定に追加してください。
freee サイン（freee-sign-mcp）
セットアップ npx --package=freee-mcp -- freee-sign-mcp configure
対話式ウィザードが認証情報の設定と OAuth 認証を行います。
MCP 設定 {
"mcpServers": {
"freee-sign-mcp": {
"command": "npx",
"args": ["--package=freee-mcp", "--", "freee-sign-mcp"]
}
}
}
コントリビューション
Contributors
開発者向け git clone https://github.com/freee/freee-mcp.git
cd freee-mcp
bun install
bun run dev # 開発サーバー（ウォッチモード）
bun run build # ビルド
bun run typecheck # 型チェック
bun run lint # リント
bun run test:run # テスト
# API リファレンスの再生成
bun run generate:references
# OpenAPI スキーマの操作数・パス数を集計（プロダクト別の内訳も表示）
bun run count:apis
技術スタック TypeScript / Model Context Protocol SDK / OAuth 2.0 + PKCE / Zod / Bun
アーキテクチャ詳細 プロジェクトのアーキテクチャ、内部構造、開発ガイドラインについては CLAUDE.md を参照してください。
License / ライセンス
コミュニティ 質問や情報交換は Discord サーバーで行っています。お気軽にご参加ください。
関連リンク
Оценка в каталоге 10/100 В каталоге 10 из 10
В официальном MCP Registry 0 из 18
Права заявлены мейнтейнером 0 из 8
Отвечает списком инструментов 0 из 12
Звёзды GitHub 0 из 16
Загрузок в неделю 0 из 10
Ohmyzsh 🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python Ruflo 🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, feder TrendRadar ⭐AI-driven public opinion & trend monitor with multi-platform aggregation, RSS, and smart alerts.🎯 告别信息过载，你的 AI 舆情监控助手与热点筛选工具！聚合多平台热点 + RSS 订阅，支持关键词精准筛选。AI 智能筛选新闻 + AI 翻译 + AI 分析简报直推手机，也支持接入 MCP 架构 Dbx 25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Dock Docker Android Android in docker solution with noVNC supported, video recording, mcp server and AI-agent TREK The most complete open-source travel planner: real-time collaboration, bookings, budgets, packing lists, journals, offline PWA, SSO and an AI-ready MCP server, with planet-wide place search and routin Pansou PanSou是一款高性能的网盘资源搜索API服务，支持TG频道和插件搜索。系统设计以性能和可扩展性为核心，支持多频道多插件并发搜索、结果智能排序和网盘类型分类。docker集成前后端，一键启动，开箱即用。仅供学习研究，请勿以各种形式用于盈利目的。 https://t.me/s/webhtv XHS Downloader 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具 Nginx Ui Yet another WebUI for Nginx Tyk Open Source API and AI Gateway supporting REST, GraphQL, TCP, gRPC and MCP (Model Context Protocol) Openstatus Open-source status page, incident response and uptime monitoring Dashboard Icons 3,400+ curated icons and logos for dashboards and AI agents. SVG, PNG and WEBP on a free CDN, plus an MCP server for Claude Code, Codex, ChatGPT, Cursor, Hermes and OpenClaw. MCP-серверы: DevOps Лучшие MCP-серверы: DevOps azure-compute Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l self-hosted-funnel-launch Deploy a self-hosted funnel builder, take a funnel from empty install to published - landing page, checkout, one-click upsell, thank-you - and drive it from an agent over MCP. Covers deploying to Clou
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
Как установить Freee? Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
Нужен ли API-ключ для Freee? В этой записи не указано обязательных переменных окружения.
Какой транспорт использует Freee? Freee работает локально через stdio.
Когда Freee проверялся в последний раз? Последняя проверка: 2026-11-15. Model Context Protocol (MCP) server for freee API integration
У инструментов есть описания 0 из 6
