How sylvianai/sv-excel-agent works
This repository provides an AI-driven Excel editing workflow: a user supplies a workbook and instruction, an agent uses spreadsheet tools exposed over MCP, and the edited workbook is saved for download or returned through an integration. The core includes both the agent runner and the Excel MCP tool server, with documented web and Slack entry points. Tool-level behavior is only sampled in part, so the graph shows confirmed orchestration and broad tool responsibilities without asserting unsupported helper-to-tool wiring.
Main entry points: agent_runner.py Agent runner · excel_server.py Tool server · excel_agent_bot.py Slack bot · server.py Web API
Components 16
Agent runtime
- Agent runner
excel_agent/agent_runner.py - Prompt and config
excel_agent/config.py - Reasoning models
excel_agent/reasoning_models.py
Excel MCP
- Tool server
excel_mcp/excel_server.py - Session management
excel_mcp/sessions.py - Workbook state
excel_mcp/models.py - Tool schemas
excel_mcp/schemas.py - Workbook operations
excel_mcp/helpers.py - Cell display
excel_mcp/formatting.py
Web assistant
- Spreadsheet UI
demo/ExcelAssistant/src/App.jsx - Web API
demo/ExcelAssistant/server.py
Slack workflow
- Slack bot
demo/SlackExcelWorkflow/excel_agent_bot.py
Other components
- Excel user
- Excel workbook
- AI model provider
- Slack
Connections 21
- Excel user → Spreadsheet UI: uploads and instructs
- Spreadsheet UI → Web API: sends task
- Web API → Tool server: starts server
- Web API → Agent runner: runs task
- Agent runner → Prompt and config: formats prompt
- Agent runner → Reasoning models: selects model
- Agent runner → Tool server: calls tools via MCP
- Agent runner → AI model provider: requests completion
- Agent runner → Excel workbook: initializes and saves
- Tool server → Session management: injects session
- Session management → Workbook state: manages workbook state
- Tool server → Tool schemas: validates tool inputs
- Tool server → Workbook operations: performs workbook operations
- Tool server → Cell display: formats cell data
- Web API → Excel workbook: stores upload and output
- Excel user → Slack: sends workbook task
- Slack → Slack bot: dispatches mention
- Slack bot → Excel workbook: downloads and stages
- Slack bot → Tool server: starts server
- Slack bot → Agent runner: runs task
- Slack bot → Slack: returns result