Excel MCP Server

Excel MCP サーバー

MS Excel のデータを読み書きする Model Context Protocol（MCP）サーバーです。

機能

• テキスト値の読み書き
• 数式の読み書き
• 新しいシートの作成

🪟Windows のみ：

• ライブ編集
• シートの画面イメージをキャプチャ

詳細については、ツールのセクションをご覧ください。

要件

• Node.js 20.x 以降

対応ファイル形式

• xlsx（Excel ブック）
• xlsm（Excel マクロ有効ブック）
• xltx（Excel テンプレート）
• xltm（Excel マクロ有効テンプレート）

インストール

NPM 経由でインストール

MCP サーバーの設定に以下の構成を追加すると、excel-mcp-server が自動的にインストールされます。

Windows の場合：

{
    "mcpServers": {
        "excel": {
            "command": "cmd",
            "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

その他のプラットフォームの場合：

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

Smithery 経由でインストール

Smithery 経由で Claude Desktop に Excel MCP Server を自動的にインストールするには：

npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude

ツール

excel_describe_sheets

指定した Excel ファイルのすべてのシート情報を一覧表示します。

引数：

• fileAbsolutePath
  • Excel ファイルの絶対パス

excel_read_sheet

ページネーションを使って Excel シートの値を読み取ります。

引数：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• range
  • Excel シートから読み取るセル範囲（例：「A1:C10」）。[デフォルト：最初のページ範囲]
• showFormula
  • 値の代わりに数式を表示します [デフォルト：false]
• showStyle
  • セルのスタイル情報を表示します [デフォルト：false]

excel_screen_capture

**［Windows のみ］**ページネーションを使って Excel シートのスクリーンショットを撮影します。

引数：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• range
  • Excel シートから読み取るセル範囲（例：「A1:C10」）。[デフォルト：最初のページ範囲]

excel_write_to_sheet

Excel シートに値を書き込みます。

引数：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • Excel ファイル内のシート名
• newSheet
  • true の場合は新しいシートを作成し、それ以外の場合は既存のシートに書き込みます
• range
  • Excel シートから読み取るセル範囲（例：「A1:C10」）。
• values
  • Excel シートに書き込む値です。値が数式の場合は「=」で始める必要があります

excel_create_table

Excel シートにテーブルを作成します

引数：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• sheetName
  • テーブルを作成するシート名
• range
  • テーブルにする範囲（例：「A1:C10」）
• tableName
  • 作成するテーブル名

excel_copy_sheet

既存のシートを新しいシートにコピーします

引数：

• fileAbsolutePath
  • Excel ファイルの絶対パス
• srcSheetName
  • Excel ファイル内のコピー元のシート名
• dstSheetName
  • コピー先のシート名

excel_format_range

Excel シート内のセルをスタイル情報で書式設定します

引数:

• fileAbsolutePath
  • Excel ファイルへの絶対パス
• sheetName
  • Excel ファイル内のシート名
• range
  • Excel シート内のセル範囲（例: "A1:C3"）
• styles
  • 各セルのスタイルオブジェクトの 2 次元配列。セルのスタイルを変更しない場合は null を使用します。配列の要素数は範囲のサイズと一致している必要があります。
  • スタイルオブジェクトのプロパティ:
    • border: 罫線スタイルの配列（type、color、style）
    • font: フォントスタイル（bold、italic、underline、size、strike、color、vertAlign）
    • fill: 塗りつぶし／背景スタイル（type、pattern、color、shading）
    • numFmt: カスタム数値書式文字列
    • decimalPlaces: 小数点以下の桁数（0〜30）

設定

以下の環境変数を使用して、MCP サーバーの動作を変更できます:

EXCEL_MCP_PAGING_CELLS_LIMIT

1 回のページング操作で読み取るセルの最大数。
[default: 4000]

ライセンス

Copyright (c) 2025 Kazuki Negoro

excel-mcp-server は MIT License の下で公開されています