freee

freee会計、人事労務、請求書、工数管理、販売、IT管理、サイン（電子契約）を AI Agent から操作できるようにする freee 公式の MCP サーバーと Agent Skills です。

- MCP サーバー: freee API の呼び出し・認証・リクエスト検証を担当
- Agent Skills: API リファレンスと操作レシピを AI Agent のコンテキストに注入し、正確な API 利用をガイド

- 複数 API 対応: 会計・人事労務・請求書・工数管理・販売・IT管理の6つの freee API をサポート
- サイン（電子契約）対応: freee サインの文書管理 API を専用コマンド（freee-sign-mcp）でサポート
- OAuth 2.0 + PKCE: セキュアな認証フロー、トークン自動更新
- 複数事業所対応: 事業所の動的切り替えが可能

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 呼び出しを担当

freee が提供する Remote MCP サーバーに接続する方法です。ローカルでのセットアップが不要で、すぐに利用を開始できます。

Claude 及び Claude Desktop では「カスタマイズ」より「カスタムコネクタを追加」を開き、以下を設定してください。

- 名前:freee
- URL:https://mcp.freee.co.jp/mcp

その他の AI ツールでは、それぞれの案内に従って Remote MCP サーバーを追加してください。

freee アプリケーションを自分で登録し、ローカルで MCP サーバーを起動する方法です。

- コールバックURL:http://127.0.0.1:54321/callback
- Client ID と Client Secret を取得
- 必要な権限にチェック

configureが出力する設定を Claude Desktop の設定ファイルに追加:

{ "mcpServers": { "freee": { "command": "npx", "args": ["freee-mcp"] } } }

Windows Store (Microsoft Store) 版の Claude Desktop をご利用の場合、設定ファイルのパスが異なります。freee-mcp configureは自動的に適切なパスを検出します。

Claude 及び Claude Desktop では「カスタマイズ」より「スキル」を開き、最新のfreee-api-skill.zipをダウンロードしてアップロードしてください。

- 最新版をダウンロード (freee-api-skill.zip)
- バージョン履歴から選ぶ:Releases ページ

Claude Code 等のコーディングエージェント（Cursor, OpenCode など）では、skillsでインストールできます。

GitHub CLI（v2.90.0 以降）のgh skillコマンドからもインストールできます。

gh skill install freee/freee-mcp freee-api-skill

Agent Package Manager (APM)を利用している場合は、以下のコマンドでもインストールできます。GitHub Copilot / Claude Code / Cursor / OpenCode / Codex など、プロジェクトに存在する対象ディレクトリに自動でデプロイされます。

apm install freee/freee-mcp/skills/freee-api-skill

claude plugin marketplace add freee/freee-mcp claude plugin install freee-mcp@freee-mcp-marketplace

/plugin marketplace add freee/freee-mcp /plugin install freee-mcp@freee-mcp-marketplace

OpenAI Codex のプラグインマーケットプレース（公式ドキュメント）にも対応しており、MCP サーバーと Agent Skills（API リファレンス・操作レシピ）をまとめて利用できます。

codex plugin marketplace add freee/freee-mcp

npx --package=freee-mcp -- freee-sign-mcp configure

{ "mcpServers": { "freee-sign-mcp": { "command": "npx", "args": ["--package=freee-mcp", "--", "freee-sign-mcp"] } } }

リクエスト（パラメータまたはボディ）にcompany_idを含める場合、現在の事業所と一致している必要があります。不一致の場合はエラーになります。

- 事業所の確認:freee_get_current_company
- 事業所の切り替え:freee_set_current_company
- company_id を含まない API（例:/api/1/companies）はそのまま実行可能

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

TypeScript / Model Context Protocol SDK / OAuth 2.0 + PKCE / Zod / Bun

プロジェクトのアーキテクチャ、内部構造、開発ガイドラインについてはCLAUDE.mdを参照してください。

- 紹介記事: Public API を MCP化するとき Agent Skill 併用が良さそう with freee-mcp
- freee API ドキュメント
- Model Context Protocol

US/HK markets — 110 tools: real-time quotes, options, orders, fundamentals, alerts, DCA & portfolio