Skip to main content
Glama
excel-live-mac
by dcol3

excel-live-mac

Live Excel MCP server for macOS — interact with running Excel instances in real time.

Unlike file-based tools (openpyxl) that work on saved files offline, this server talks to the live Excel app via the xlwings AppleScript bridge. Changes appear instantly in the spreadsheet you're looking at.

Features

  • 10 tools for reading, writing, and interacting with open Excel workbooks

  • Real-time updates — write data and watch it appear in Excel immediately

  • Formula support — write Excel formulas that calculate live

  • VBA macro execution — trigger existing macros from your AI agent

  • Selection awareness — read what the user currently has highlighted

  • Zero config — no API keys, no network, runs entirely local

Related MCP server: SheetForge MCP

Requirements

  • macOS (AppleScript bridge — not available on Windows/Linux)

  • Microsoft Excel installed

  • Python 3.10+

Installation

For Kiro IDE (as a Power)

Import from GitHub in the Kiro Powers panel:

https://github.com/dcol3/excel-live-mac

For any MCP client (via uvx)

uvx --from git+https://github.com/dcol3/excel-live-mac excel-live-mac

Or add to your MCP config:

{
  "mcpServers": {
    "excel-live-mac": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/dcol3/excel-live-mac", "excel-live-mac"],
      "disabled": false
    }
  }
}

Manual install

pip install excel-live-mac
excel-live-mac

macOS Permission

On first use, macOS will prompt you to allow your terminal to control Microsoft Excel.

Go to System Settings → Privacy & Security → Automation and ensure your terminal/IDE has permission to control Excel.

Tools

Tool

Description

excel_list_workbooks

List all open workbooks (name, path, sheets)

excel_get_sheet_names

Get sheet names from a workbook

excel_read_range

Read a cell range as a 2D array

excel_write_range

Write a 2D array (appears instantly)

excel_write_cell

Write a value or formula to one cell

excel_read_cell

Read one cell's value and formula

excel_open_workbook

Open a file in Excel

excel_save_workbook

Save the workbook

excel_run_macro

Execute a VBA macro

excel_get_selection

Get the current selection

Use Cases

  • Report generation — AI builds formatted spreadsheets while you watch

  • Financial modeling — populate budgets, forecasts, and scenario tables live

  • Data entry automation — read from databases, write directly into open workbooks

  • Interactive analysis — AI reads your current selection, computes, writes results back

Kiro Power

This repo includes a kiro_power/ directory with POWER.md, mcp.json, and steering files for use as a Kiro Power. When installed as a Power, Kiro's agent automatically knows when and how to use these tools based on keyword activation.

License

MIT

Available Tools

10 tools
excel_get_selectionB

Get info about the currently selected range in Excel (address, values, sheet).

Inputs: no named parameters.

excel_get_sheet_namesA

Get all sheet names from an open workbook.

Inputs: workbook.

excel_list_workbooksA

List all currently open workbooks in Excel. Shows name, path, and sheet count.

Inputs: no named parameters.

excel_open_workbookB

Open a workbook file in Excel. Launches Excel if not running.

Inputs: file_path (required).

excel_read_cellB

Read the value of a single cell.

Inputs: cell (required), workbook, sheet.

excel_read_rangeA

Read a range from an open workbook. Returns cell values as a 2D array.

Inputs: range (required), workbook, sheet, expand.

excel_run_macroB

Run a VBA macro in the active workbook. Macro must already exist in the workbook.

Inputs: macro (required), workbook, args.

excel_save_workbookB

Save the specified (or active) workbook.

Inputs: workbook, path.

excel_write_cellA

Write a single value to a specific cell. Change appears immediately.

Inputs: cell (required), value (required), workbook, sheet.

excel_write_rangeB

Write a 2D array of data to a range in an open workbook. Changes appear immediately in Excel.

Inputs: range (required), data (required), workbook, sheet.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct action: reading/writing cells vs ranges, listing sheets, managing workbooks, running macros. No overlapping purposes; descriptions clearly differentiate them.

    Naming Consistency5/5

    All tools share the 'excel_' prefix and follow a consistent verb_noun pattern (e.g., read_cell, write_range, open_workbook), making it easy to infer functionality.

    Tool Count5/5

    With 10 tools, the server covers essential Excel operations without being bloated or sparse. Each tool serves a clear need.

    Completeness3/5

    Basic CRUD on cells/ranges and workbook listing/saving are covered, but missing features like creating workbooks, managing sheets, closing workbooks, or formatting leave notable gaps for full automation.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for manipulating Excel files that features a headless engine for real-time formula calculation and data validation. It enables users to create, read, and manage workbooks, sheets, and charts without requiring Microsoft Excel installed.
      26 npm
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Local-first Excel MCP server for AI agents enabling structured reads, workbook introspection, and safer .xlsx mutation without Microsoft Excel or LibreOffice.
      83
      60 PyPI
      3
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Excel-compatible formula evaluation and workbook operations, enabling agents to open, inspect, mutate, recalculate, and save .xlsx files in-memory over stdio.
      83 npm
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides full read and write access to Excel workbooks (sheets, cell ranges, tables, formulas, formatting, and cross-workbook references) via MCP, running locally or as an HTTP/SSE service.
      17 npm
      MIT