hank-excel-mcp

Python package for connecting Excel to AI via MCP.

See the main README for full documentation.

Install

pip install hank-excel-mcp==0.1.0

The distribution is hank-excel-mcp; the Python import remains excel_mcp and the console command remains excel-mcp. For package development, use pip install -e . from this directory instead.

Components

• excel_mcp.mcp_server — MCP stdio server (python -m excel_mcp)
• excel_mcp.relay — relay state and create_relay_app() factory; an embedding application must supply request authentication
• excel_mcp.tool_registry — built-in workbook tools plus register_tools() extensibility
• excel_mcp.mcp_server.channel_status — relay/taskpane health and recovery inspection

The live MCP server currently exposes 26 tools: channel_status plus the registry-backed workbook tools. Inspect the registered surface in process when changing either owner.

excel-mcp start is a host-repository convenience command that launches api.main:app; it is not a standalone authenticated relay. Portable consumers should embed create_relay_app() with their own request authenticator.