Excel MCP Skill
Excel ファイルの読み書き・書式設定を行うための MCP ツール群。
2つのモード
workbook— 開いている Excel ブックをリアルタイム操作（xlwings）path— 閉じた .xlsx ファイルを直接編集（Excel 不要、画像・グラフを壊さない）
どちらか一方を指定する。両方指定しない。
基本フロー
閉じたファイルを扱う場合
read_cellsで現状を確認（path, range, formats=true）write_cellsで値を書き込む（path, range, value）format_cellsで書式を整える（path, range, format）
開いている Excel を扱う場合
get_excel_infoでブック名・シート名を取得read_cells/write_cells/format_cellsを workbook 指定で使う- 複雑な操作は
execute_vbaで VBA を実行（開いている時のみ）
ツール早見表
| ツール | workbook | path | 必須パラメータ |
|---|---|---|---|
| get_excel_info | - | - | なし |
| read_cells | OK | OK | range |
| write_cells | OK | OK | range, value |
| format_cells | OK | OK | range, format |
| execute_vba | OK | ✕ | workbook, code |
value の指定方法
単一値: "hello" / 42 / true
1行: ["A", "B", "C"]
複数行: [["A1","B1"], ["A2","B2"]]
1列: range="A1:A3", value=["x","y","z"]
range のサイズと value の形状を合わせる。単一値を範囲に書くと全セルに同じ値が入る。
format の指定方法
{
"bold": true,
"fontSize": 14,
"fontColor": "#FF0000",
"backgroundColor": "#FFFF00",
"textAlign": "center",
"numberFormat": "#,##0",
"borders": {
"outside": { "style": "thin", "color": "#000000" }
}
}
使えるプロパティ: bold, italic, underline, fontSize, fontName, fontColor, backgroundColor, textAlign (left/center/right), verticalAlign (top/middle/bottom), numberFormat, wrapText, borders
borders の位置: top, bottom, left, right, inside, outside borders の style: thin, medium, thick, double, dotted, dashed, none
注意点
pathモードは .xlsx 形式のみ対応（.xls, .csv は不可）pathモードで編集してもExcelには即反映されない（ファイルを開き直す必要あり）execute_vbaは開いているブック専用。閉じたファイルには使えない- sheet を省略すると最初のシート（またはアクティブシート）が対象
- 大きな範囲を一度に読むより、必要な範囲だけ指定する方が高速