Excel MCP Server 讓 AI 直接讀寫本機 .xlsx,不必先開啟 Microsoft Excel。這篇使用 Haris Musa 維護的 Python 版本,適合整理報表、補公式與核對金額;如果只是請 AI 解釋一段貼上的資料,直接貼表格就夠了。搜尋結果裡有好幾個同名專案,安裝前先核對套件是 excel-mcp-server。
Windows 安裝與連線
先準備 uv 和 Python 3.12。以下在一個新的工作資料夾用 PowerShell 執行。固定 2.3.1,避免舊版工具名稱與新版混用。
uv venv --python 3.12 .venv
uv pip install --python .\.venv\Scripts\python.exe excel-mcp-server==2.3.1
New-Item -ItemType Directory -Force workbooks | Out-Null
$server = (Resolve-Path .\.venv\Scripts\excel-mcp-server.exe).Path
$books = (Resolve-Path .\workbooks).Path
Claude Code:
claude.cmd mcp add excel --scope project --env PYTHONUTF8=1 --env PYTHONIOENCODING=utf-8 -- $server stdio --allow-dir $books
claude.cmd mcp list
看到 Connected 後,在這個專案重新開啟 Claude Code。Codex 使用相同執行檔:
codex mcp add excel --env PYTHONUTF8=1 --env PYTHONIOENCODING=utf-8 -- $server stdio --allow-dir $books
codex mcp list
Codex 的註冊會保存在使用者設定;--allow-dir 才是伺服器讀寫檔案的範圍。範例只開放 workbooks,相對檔名 sales.xlsx 就會落在這裡。這也避免把整個磁碟的活頁簿交給工具。
Cursor 可依上游的 Cursor 設定,在 .cursor/mcp.json 使用同一個執行檔、stdio 和允許目錄;Windows JSON 裡的反斜線要寫成 \\,或改用 /。
三個可以直接用的任務
1. 建立一份可交接的報表
貼給已接上工具的 AI:
只用 Excel MCP。建立 sales.xlsx,工作表 Sales。
A1:B4 寫入:Region,Amount;Taipei,120;Taipei,80;Kaohsiung,50。
B5 寫入公式 =SUM(B2:B4)。完成後讀回 A1:B5,不要只回覆「已建立」。
2.3.1 會使用 create_workbook、write_range 和 read_range。檔案存好後,數值模式的 B5 應是 250;這一步可以把「AI 說寫好了」和真正的檔案內容分開確認。
2. 分清公式與計算結果
用 read_range 讀 sales.xlsx 的 Sales!A1:B5,先用 mode=values,
再用 mode=formulas。列出 B5 的兩種回應,不要把公式字串當成數值。
我們讀到的值是 250,公式是 =SUM(B2:B4)。這個版本有本機公式計算能力,因此沒用 Excel 開過檔案也能讀到這個 SUM 結果;不能由此推論所有 Excel 函數都能計算。遇到不支援的公式,先看回應的 uncalculated,再決定是否要交給 Excel 計算。
3. 確認工具沒有越過指定資料夾
在自己的測試資料夾執行這個唯讀要求:
用 Excel MCP 嘗試讀 ../outside.xlsx,記錄原始錯誤;不要建立這個檔案,
也不要改設定或移動檔案來繞過限制。
我們收到 Path '../outside.xlsx' is outside the allowed directories.。這是路徑限制生效,不是檔案損毀;正常報表應放回允許目錄內,再使用相對檔名。
常見錯誤
error: unknown option '--allow-dir': PowerShell 呼叫 npm 的claude.ps1時,未加引號的--可能先被 PowerShell 處理掉,後面的伺服器選項就落到 Claude。改用上面的claude.cmd保留分隔符;我們用相同伺服器與參數重新註冊後得到 Connected。- 找不到
uvx或伺服器執行檔: AI 客戶端的 PATH 可能和終端機不同。使用上面Resolve-Path得到的完整.exe路徑,並確認虛擬環境沒有被搬走。 - 出現
outside the allowed directories: 相對路徑以允許目錄為基準。已經指定workbooks時,傳sales.xlsx,而不是再加一層workbooks/sales.xlsx;不要用..取其他位置的檔案。 - 舊提示詞找不到工具或參數: 2.x 的工具與欄位經過改名。本例是
write_range的at、rows,以及read_range的mode;先讓 AI 取得目前工具結構,別沿用 1.x 範例。 - 公式有字串卻沒有結果: 用
formulas確認公式確實存在,再檢查values的未計算說明。讀取公式字串和驗證計算正確是兩件事。
費用、限制與替代選擇
伺服器採 MIT 授權,本機操作不需要 Microsoft 365、服務帳戶或 API key;AI 客戶端本身的用量另外計算。它處理現代 Excel 檔案,不支援舊 .xls,也不是畫面上的 Excel 自動化。複雜公式、巨集與樞紐分析表應另做檔案驗證;本篇的 SUM 例子沒有涵蓋這些功能。
如果資料原本在 CSV,目的是反覆查詢加總而不是交付活頁簿,DuckDB MCP 比維護儲存格位置合適。只需要替 AI 讀一般文字檔,可看 Filesystem MCP。
FAQ
Excel MCP 需要安裝 Excel 嗎?
這篇選的 Haris Musa 版本不需要,它直接操作活頁簿檔案。同名的其他專案可能使用 Windows COM 或正在開啟的 Excel,因此不能把它們的需求混在一起。先看套件和上游,再套用設定。
Claude Code 和 Codex 可以共用同一份報表嗎?
可以把兩個客戶端指向相同允許目錄,但應輪流修改同一檔案。每次修改後讀回內容,避免兩個 AI 同時存檔覆蓋彼此的變更。mcp list 用來確認設定或連線,報表是否正確仍要靠實際讀回。
沒開 Excel,SUM 為什麼會有答案?
2.3.1 會在沒有可用快取值時,對支援的公式做本機計算。我們以同一個 B5 同時讀到公式字串與數值 250,並從存檔確認公式仍在。這是這個範例的結果,不是完整 Excel 計算引擎相容性的結論。
我們測了什麼
2026-11-16:Windows、Python 3.12、excel-mcp-server 2.3.1、Codex CLI 0.169.0。Codex 真正建立與讀回活頁簿,驗證 SUM=250、公式保存及越界拒絕;Claude Code 完成註冊與 Connected 檢查。Cursor、大型活頁簿及進階公式未實機測試;設定與功能範圍參考官方 README與工具說明,查閱日期同上。