freee-mcp

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

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

[](https://www.npmjs.com/package/freee-mcp)

• 複数 API 対応: 会計・人事労務・請求書・工数管理・販売の5つの freee API をサポート
• 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

> ⚠️ freee 公式以外の URL を入力しないようにご注意ください。

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

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

freee アプリストア で新しいア