Excel MCP Server

Excel MCP サーバー

Claude、Cursor、VS Code Copilot、Codex などの AI クライアントが、グラフ、ピボットテーブル、数式、テーブルなどの Excel ファイルを作成、読み取り、編集できる、オープンソースのモデルコンテキストプロトコル（MCP）サーバーです。openpyxl をベースに構築されており、Microsoft Excel は不要で、Windows、macOS、Linux で動作します。

excelmcpserver.com でインストールしてお試しください。または、以下のクイックスタートをご覧ください。

機能

グラフとピボットテーブル

• AI で Excel グラフを作成できます。縦棒、横棒、折れ線、面、円、ドーナツ、レーダー、散布図、バブルの各グラフに対応し、複合グラフ、第 2 軸、近似曲線、誤差範囲も利用できます
• Excel 2016 のグラフの種類：ウォーターフォール、ヒストグラム、パレート図、箱ひげ図、ツリーマップ、サンバースト、ファネル
• Excel で更新できる本物のピボットテーブル（グループ化、計算フィールド、「値の表示方法」、レイアウト、フィルター）に加え、ピボットテーブルとテーブル用のスライサーやタイムライン
• スパークライン（折れ線、縦棒、勝敗）

数式と動的配列

• 組み込みエンジンが Excel を使わずに数式を計算します（約 260 個の関数に対応し、実際の Excel で記録された 2,500 個以上の数式と照合済み）。そのため、Excel で一度も開いていないファイルでも read_range が値を返します
• 動的配列（FILTER、SORT、UNIQUE、SEQUENCE、LET）は Excel と同じ形式で保存され、隣接するセルにスピルします
• 数値が間違っている理由を調べられます。シート、名前、テーブルをまたいで参照元と参照先を追跡し、Excel の「数式の検証」のように数式をステップごとに評価できます
• ゴールシーク：数式が目標値に達するまで入力値を変更します

データ、テーブル、ルール

• セル、日付、ハイパーリンクの読み取りと書き込み、集計行と計算列を含むテーブル
• 条件付き書式（カラースケール、データバー、アイコンセット、上位／下位、重複、テキスト、日付）、データの入力規則（ドロップダウン、制限、入力メッセージ）
• 並べ替え、フィルター（条件指定）、検索と置換、重複の削除、区切り位置、連続データの作成、形式を選択して貼り付け
• フォント、塗りつぶし、罫線、数値形式、セルの結合、ウィンドウ枠の固定、グループ化、印刷設定、シート保護、画像、メモ、定義名。行や列を挿入または削除すると、Excel と同様にすべての参照が更新されます

大容量ファイル

• 読み取りではブックをストリーム処理してページ単位で返すため、数十万行あるシートでもメモリ使用量は一定です。すべての呼び出しにはサイズとセル数の上限があります
• XML が 1 MB 以上のシートの編集では、操作対象の行のみを解析します。そのため、20 万行のシートでの行や列の挿入・削除、並べ替え、置換、シートのコピー、ピボットテーブルの作成にかかる時間は、数分ではなく数秒です

マクロ（オプトイン）

• .xlsm ファイル内の VBA コードを読み取れます。--allow-vba-write を指定してサーバーを起動しない限り、VBA の書き込みは無効です。サーバーがマクロを実行することはありません

安全性を重視した設計

• オプションのフォルダー制限、数式の安全性チェック、読み取り専用モード、デフォルトでの localhost 限定 HTTP、途中までしか書き込まれたファイルを残さないアトミック保存

.xlsx、.xlsm（マクロは保持されます）、.xltx、.xltm ファイルに対応しています。既存のスレッド形式のコメント、図形、フォームコントロールなど、ツールで編集できないコンテンツはそのまま保持されます。

クイックスタート

uv が必要です。すべてのクライアントは、 uvx excel-mcp-server stdio でサーバーを実行します。/path/to/workbooks は、サーバーが使用できる フォルダーに置き換えてください。excelmcpserver.com には、コピーボタンと Cursor および VS Code 用のワンクリックインストールリンク付きで、同じ手順が掲載されています。

Claude Desktop（Chat）：最新リリースから excel-mcp-server.mcpb をダウンロードして開きます。Claude から、サーバーが使用できるフォルダーを尋ねられます。

Claude Code（CLI、および Claude Desktop の Code タブ）：

claude mcp add excel --scope user -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Cursor（~/.cursor/mcp.json）、および mcpServers 設定を使用するほとんどのクライアント：

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": ["excel-mcp-server", "stdio", "--allow-dir", "/path/to/workbooks"]
    }
  }
}

GitHub Copilot を使用する VS Code（.vscode/mcp.json。servers キーに注意してください）：

{
  "servers": {
    "excel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["excel-mcp-server", "stdio", "--allow-dir", "${workspaceFolder}"]
    }
  }
}

codex mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

gemini mcp add -s user excel uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

devin mcp add -s user excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

デスクトップアプリでは、シェルの PATH が参照できないため（macOS でよくあります）、uvx が見つからないことがよくあります。 代わりにフルパスを使用してください。フルパスは which uvx で確認できます。

使用できるファイルの選択

--allow-dir DIR を指定すると、サーバーは DIR 内（サブフォルダーを含む）のワークブックのみを開きます。 reports/q1.xlsx のような相対パスは、そのフォルダーを起点とします。複数のフォルダーを許可するには、このフラグを繰り返し指定するか、 EXCEL_FILES_PATH を設定します（フォルダーは macOS/Linux では :、Windows では ; で区切ります）。

--allow-dir を指定しない場合、Excel ファイルへの絶対パスであれば使用できます。どのモードでも、サーバーが操作するのは Excel ファイルのみで、 既存のワークブックを黙って上書きすることはありません。

リモート利用（Streamable HTTP）

uvx excel-mcp-server streamable-http --allow-dir /srv/workbooks

クライアントは http://127.0.0.1:8017/mcp に接続します。ワークブックは --allow-dir フォルダー（デフォルトは ./excel_files）に保存され、 export_workbook / import_workbook により、サーバーとクライアントの間でファイルを移動します。

サーバーは localhost のみで待ち受けます。他のマシンからの接続を受け入れるには、トークンとホストを設定します。

EXCEL_MCP_AUTH_TOKEN=change-me uvx excel-mcp-server streamable-http --host 0.0.0.0

クライアントは Authorization: Bearer change-me を送信します。ネットワーク越しに使用する場合は、TLS を終端するリバースプロキシを サーバーの前に配置してください。

Docker

docker build -t excel-mcp-server .
docker run -p 8017:8017 -v "$PWD/workbooks:/data" -e EXCEL_MCP_AUTH_TOKEN=change-me excel-mcp-server

設定

ツール

ツールの選択

すべてのツールは、リクエストごとにコンテキストを消費します。--tools では、コアツール（describe_workbook、describe_sheet、read_range）と、指定した領域のみを利用できます。たとえば、uvx excel-mcp-server stdio --tools data,charts のように指定します。--read-only（各領域の読み取り専用ツール）および --allow-vba-write（vba 領域も必要）と併用できます。不明な領域を指定すると、サーバーは起動時に停止し、有効な領域の一覧を表示します。サイズはツールの説明とスキーマの文字数で、1トークンあたり約3.5文字です。

CSV

import_csv は .csv または .tsv ファイルをシートにセル位置を指定して読み込みます（シートが存在しない場合は作成します）。export_csv は範囲を CSV として書き出します。どちらも許可されたフォルダー内で、--max-cells と --max-file-mb の制限内で動作し、処理を実行することはありません。

• インポート時は、最初のレコードから区切り文字を判定します（または comma、semicolon、tab、pipe を指定します）。UTF-8（BOM の有無を問わず）、UTF-16、cp1252 を読み込みます。引用符で囲まれたフィールドと、その中の改行は保持されます。
• フィールドは Excel のインポートと同様に型変換されます。数値（1,234.50、12% も含む。小数点にカンマを使う場合は decimal）、TRUE／FALSE、ISO 日付（2026-01-31、2026-01-31 09:30）は値になります。Excel が変更するテキストはテキストのままです。先頭のゼロ（007）、15 桁を超える数値、先頭の +、数値形式の日付（01/02/2026）が該当します。数値形式の日付は、指定した date_order（dmy または mdy）でのみ読み込まれます。as_text を指定すると、すべてのフィールドがテキストとして保持されます。
• フィールドが数式になることはありません。=、+、-、@ で始まるテキストは Excel の引用符プレフィックスを付けてテキストとして保存されるため、セルを編集しても実行されません。-5 のような数値は数値として扱われます。
• エクスポートでは、生の値（完全な精度、ISO 日付）を書き出すか、formatted を指定して Excel に表示される値を書き出します。=、+、-、@ で始まるテキストセルには ' プレフィックスを付けます（既定では escape_formulas が有効）。これにより、ファイルを開いたスプレッドシートで内容が実行されません。数値にはプレフィックスを付けません。日時は 2026-01-31T09:30:00 として書き出され、Excel ではテキストとして開かれます。Excel 用には formatted を使用してください。 UTF-8 ファイルをダブルクリックで開いたときに Excel でアクセント記号を正しく表示するには、BOM を付けるために encoding: utf-8-sig を使用します。行末は CRLF です。

各パラメーターの説明は TOOLS.md に記載されています。パラメーターの意味はすべてのツールで共通です。

ブックを変更するツールは、変更した内容（sheet、range、name）を返すため、次の呼び出しで参照できます。グラフと画像は、describe_sheet に表示される名前で指定します。

マクロの書き込み（オプトイン）

--allow-vba-write（または EXCEL_MCP_ALLOW_VBA_WRITE=1）を指定すると、サーバーは .xlsm および .xltm ファイル内の標準モジュール、クラスモジュール、ブックモジュール、シートモジュールのコードを設定し、標準モジュールとクラスモジュールを削除し、新しい .xlsm／.xltm ブックを作成できます。サーバーはコードを保存するだけで、実行することはありません。また、マクロを有効にする前に Excel が確認を求めます。変更すると署名が無効になるため、デジタル署名された VBA プロジェクトは拒否されます。

Warning: マクロを Excel で有効にすると、ユーザーの権限でコードが実行されます。信頼できないコンテンツを読み取るモデルは、悪意のあるコードを書き込むよう誘導される可能性があります。このオプションは信頼できるワークフローでのみ有効にし、--allow-dir の範囲を狭く保ち、マクロを有効にする前にコードを確認してください。--read-only モードでは、これらのツールは提供されません。

セキュリティ

• 数式は書き込む前に解析されます。ネットワークや他のプログラムにアクセスする関数（WEBSERVICE、IMAGE、RTD、CALL、Google Sheets の IMPORTXML など）、Excel 4.0 マクロ関数（FILES、GET.WORKBOOK、RUN など）、DDE リンク、他のブックへの参照は拒否されます。HYPERLINK は、固定の http(s)://、mailto:、または #Sheet!A1 のリンクのみ許可されます。
• パスは、許可されたフォルダーと照合する前に、シンボリックリンクを含めて解決されます。ネットワーク（UNC）パスと Windows デバイスパスは常に拒否されます。
• 1 回の呼び出しで処理できるセル数は最大 100,000 個（--max-cells）です。大量の読み取り結果はページに分けて返されます。
• セルの内容はファイル由来のデータです。サーバーは、その中に記載された指示に従わないようモデルに伝えますが、信頼できないソースのブックに対してアシスタントがどのように動作するかを確認してください。

脆弱性は非公開で報告してください。詳しくは SECURITY.md をご覧ください。

制限事項

• 数式はファイルに保存され、Excel はファイルを開いたときに数式を計算します。そのため、それより前に read_range を使う場合に便利な values モードでは、保存済みの結果がない数式を組み込み計算機で計算します（数学、統計、金融・債券、日付、テキスト、検索、論理、LET、並べ替え、フィルターなど、約 260 個の関数に対応しています）。Excel が保存した結果が常に優先されます。計算機で Excel とまったく同じ結果を再現できない数式（未対応の関数、循環参照、または再現できない Excel の仕様上の挙動）は null として返され、理由とともに uncalculated に記載されます。推測で結果を返すことはありません。Excel の通常の（配列数式として入力されていない）数式が同じ動作をする場合、数式内の範囲は数式と同じ行または列に縮小されます。また、RAND などの揮発性関数は計算されません。この計算機は、実際の Excel から記録した 2,500 個を超える数式（tests/fixtures/formula_golden.json）と照合されています。
• trace_formula と goal_seek はこの計算機を使用するため、計算できない数式に対して goal_seek は処理を拒否します。Excel の「参照元のトレース」で OFFSET の起点となるセルが表示される場合、trace_formula は INDIRECT と OFFSET が参照するセルを表示します。それらを特定できない場合、数式は unknown に記載されます。Excel の検索が「解が見つからなかった可能性があります」というメッセージで停止する場合でも、goal_seek は解を見つけることがあります。また、収束した場合に限り（Excel と同様に、目標値との差が 0.001 以内の場合）、解を保存します。
• Excel が 2007 年以降に追加した関数（IFS、XLOOKUP、STDEV.S、SORT など）は、数式が保存される場所（セル、コピー・並べ替え後のセル、条件付き書式、データの入力規則、定義名）を問わず、Excel が求める _xlfn. 接頭辞を付けて記述されます。
• 旧形式の .xls ファイルには対応していません。CSV ファイルには import_csv を使用してください。
• ピボットテーブルはスナップショットから作成され、最大 3,000,000 セルまでのテキスト、数値、日付の列を使用できます（--max-pivot-cells）。Excel はライブソースデータから更新します。数値形式、「値の表示方法」（合計、行、列、親に対する割合、差分、累計、順位）、ラベルまたは値による並べ替え、日付と数値のグループ化、計算フィールド、コンパクト、アウトライン、表形式のレイアウト、小計のオン・オフ、項目を選択するフィルター、値フィールドの列または行への配置に対応しています。セルに書き込まれる数値は、更新後に Excel が表示する値です。これは実際の Excel から記録した約 200 個のピボットテーブル（tests/fixtures/pivot_golden.json）と照合されています。例外として、値で並べ替えたときに同順位の項目は、更新時に順序が入れ替わる場合があります。また、values_in: "rows" は順位の値と併用できません。さらに、小計がある場合は、フィールド内の他の値とも併用できません。Excel ではその場合、値フィールドが混在するためです。
• add_slicer は、テーブルとピボットテーブルにスライサー（挿入 > スライサー）を追加し、ピボットテーブルの日付フィールドにはタイムラインを追加します。フィールド、キャプション、位置とサイズ、列数、スタイル、並べ替え、選択項目（または期間）、「データのない項目を非表示」に対応しています。項目を選択すると、クリックした場合と同様にフィルターが適用されます。テーブルの行はフィルター処理されて非表示になり、ピボットテーブルの項目は非表示になって、ソースから数値が再計算されます。これは更新時に Excel で確認されています（約 200 個のピボットテーブルを Excel と照合し、スライサーの各パターンも Excel 自体の結果と照合しています）。キャッシュを共有する複数のピボットテーブル（コピーしたシート上のものなど）を、1 つのスライサーでフィルターできます。制限事項：Excel で作成または更新されたピボットテーブルは、セル内の数値を保持します（非表示項目と、ファイルを開いたときに更新する設定が保存されるため、Excel はファイルを開くと再計算します）。ピボットテーブルでグループ化されたフィールドにはスライサーを設定できません。
• 行や列の挿入・削除、シート名の変更では、Excel と同様に参照が更新されます。ハイパーリンクの参照先と 3D 参照（Sheet1:Sheet3!A1）は変更されません（Excel も同じ動作をします）。配列数式、ピボットテーブル、テーブルの見出し、または 2 つのテーブルを同時にまたぐ編集は拒否されます。挿入したセルには、上または左の行・列の書式、行の高さ、列の幅が引き継がれます（先頭の行または列には引き継がれません）。また、テーブル内に行を挿入すると、計算列がその行にも入力されます。
• ブックを編集しても、ツールで変更できない要素は保持されます。スパークライン、拡張された条件付き書式とデータの入力規則、スライサーとタイムライン、新しい種類のグラフ（ウォーターフォール、ヒストグラム、ツリーマップなど）、スレッド形式のコメント、図形、フォームコントロール、リンクされたデータ型、カスタム XML は、Excel が保存した状態のまま保持され、行や列の挿入・削除、シート名の変更に合わせて移動します。copy_sheet は、スパークライン、スライサーとタイムライン（Excel と同様）、条件付き書式の Excel 2010 対応部分（データバー、アイコンセット）、create_chart で作成した Excel 2016 のグラフをコピーしますが、それ以外はコピーしません。シートを削除すると、そのシートだけで使用していたスライサーは削除されます。対応するピボットテーブルがなくなるスライサーがある場合、削除は拒否されます。また、テーブル、またはテーブルのスライサーがフィルターする列を削除すると、そのスライサーも削除されます。 デジタル署名は、署名済みファイルを変更したときに Excel が行うのと同様に削除されます。
• 複数の値を返す数式（FILTER、SORT、UNIQUE、SEQUENCE、A2:A9*2）は、Excel と同様に動的配列数式として保存され、隣接するセルにスピルします。セルがスピルを妨げる場合、Excel は #SPILL! を表示し、write_range はその状態を報告します。計算機で結果の大きさを判定できない場合、数式のセルだけが保存され、ファイルを開いたときに Excel が残りのセルを埋めます。

1.x からのアップグレード

バージョン 2.0 では、ツール間でツール名とパラメーター名を統一したため、1.x のクライアントと保存済みのプロンプトに互換性がなくなりました。変更履歴には、1.x のすべての名前と 2.0 での置き換え後の名前を対応付けた表があります：1.x からのアップグレード。0.x からアップグレードする場合は、まず1.0.0 の変更点をご覧ください。

貢献

貢献を歓迎します。CONTRIBUTING.mdをご覧ください。

ライセンス

MIT です。LICENSEをご覧ください。