freee-api-skill

freee accounting, HR, invoicing, project management, and sales API access through MCP with detailed references and operation guides. freee の会計・人事労務・請求書・工数管理・販売のデータを AI から直接操作できるスキルです。 freee-mcp (MCP サーバー) を通じて freee API と連携。 このスキルの役割: 接続方法は Remote MCP（推奨）とローカルの2つがあります。現在の接続モードは freee_server_info の transport フィールド（ remote または stdio ）で確認できます。 freee が提供する Remote MCP サーバーに接続する方法です。ローカルでのセットアップが不要で、すぐに利用を開始できます。 Claude 及び Claude Desktop では「カスタマイズ」より「カスタムコネクタを追加」を開き、以下を設定してください。 初回接続時にブラウザで freee への認証が自動的に行われます。 npx freee-mcp configure の実行は不要です。 その他の AI ツールでは、それぞれの案内に従って Remote MCP サーバーを追加してください。 freee アプリケーションを自分で登録し、ローカルで MCP サーバーを起動する方法です。 ブラウザで freee にログインし、事業所を選択します。設定は ~/.config/freee-mcp/config.json に保存されます。 Claude を再起動後、 freee_auth_status ツールで認証状態を確認。 API リファレンスが references/ に含まれます。各リファレンスにはパラメータ、リクエストボディ、レスポンスの詳細情報があります。 目的のAPIを探すには、 references/ ディレクトリ内のファイルをキーワード検索してください。 主なリファレンス: 認証・事業所管理: サーバー情報: ファイル操作: API 呼び出し: serviceパラメータ (必須): 接続モードが不明な場合は freee_server_info で確認できます（transport が remote なら Remote MCP、 stdio ならローカル）。Remote MCP の場合、認証は自動処理されるため手順1から開始できます。ローカルモードで未認証の場合は先に freee_authenticate を実行してください。 注意: よくある操作のユースケースサンプルとTipsは以下を参照: freee サインは別の MCP サーバー（ freee-sign-mcp ）で提供されます。 sign_api_get 等のサインツールが利用可能な場合は SIGN-GUIDE.md を参照してください。 freee のデータを表示・可視化する際は、以下の色を使用してページ全体の統一感を保つこと。 文字色: 見出し #1e46aa / 本文 #23418c / キャプション #323232 / リンク #00b9b9 #2864f0 #1e46aa / 強調...