Stefan Broenner
14f55380f6
* fix: update .NET 8 references to .NET 10 across all documentation Fixes #347 Updates all references from .NET 8 to .NET 10 in: Documentation: - vscode-extension/README.md - runtime requirements - vscode-extension/DEVELOPMENT.md - bundled server description - docs/CONTRIBUTING.md - prerequisites - docs/AZURE_SELFHOSTED_RUNNER_SETUP.md - VM setup instructions - docs/INSTALLATION.md - troubleshooting section - docs/SECURITY.md - dependency information - docs/DEVELOPMENT.md - COM interop modernization note - src/ExcelMcp.ComInterop/README.md - requirements section - infrastructure/azure/README.md - software list Code/Infrastructure: - vscode-extension/src/extension.ts - runtime version request (10.0) - infrastructure/azure/azure-runner.bicep - output message - infrastructure/azure/setup-runner.ps1 - SDK installation - .github/workflows/deploy-azure-runner.yml.disabled - setup instructions - .github/workflows/release-vscode-extension.yml - release notes - .github/agents/copilot-instructions.md - technology references - specs/DATA-MODEL-DAX-FEATURE-SPEC.md - compatibility note - tests/ExcelMcp.Core.Tests/InspectTemplate.csx - path reference * fix: remove obsolete SEO section and delete test results file * fix: update .NET version reference to require .NET 10.0 in CHANGELOG --------- Co-authored-by: Stefan Broenner <stefan.broenner@microsoft.comm>
Excel MCP Server - AI-Powered Excel Automation
Control Microsoft Excel with AI through GitHub Copilot - just ask in natural language!
MCP Server for Excel enables AI assistants (GitHub Copilot, Claude, ChatGPT) to automate Excel through natural language commands. Automate Power Query, DAX measures, VBA macros, PivotTables, Charts, formatting, and data transformations - no Excel programming knowledge required.
🛡️ 100% Safe - Uses Excel's Native COM API - Zero risk of file corruption. Unlike third-party libraries that manipulate .xlsx files directly, this project uses Excel's official API ensuring complete safety and compatibility.
💡 Interactive Development - See results instantly in Excel. Create a query, run it, inspect the output, refine and repeat. Excel becomes your AI-powered workspace for rapid development and testing.
🧪 LLM-Tested Quality - Tool behavior validated with real AI agents using agent-benchmark. We test that LLMs correctly understand and use our tools.
Features
The Excel MCP Server provides 21 specialized tools with 182 operations for comprehensive Excel automation:
- 🔄 Power Query (1 tool, 10 ops) - Atomic workflows, M code management, load destinations
- 📊 Data Model/DAX (2 tools, 17 ops) - Measures, relationships, model structure
- 🎨 Excel Tables (2 tools, 24 ops) - Lifecycle, filtering, sorting, structured references
- 📈 PivotTables (3 tools, 30 ops) - Creation, fields, aggregations, calculated members/fields
- 📉 Charts (2 tools, 14 ops) - Create, configure, manage series and formatting
- 📝 VBA (1 tool, 6 ops) - Modules, execution, version control
- 📋 Ranges (4 tools, 42 ops) - Values, formulas, formatting, validation, protection
- 📄 Worksheets (2 tools, 16 ops) - Lifecycle, colors, visibility, cross-workbook moves
- 🔌 Connections (1 tool, 9 ops) - OLEDB/ODBC management and refresh
- 🏷️ Named Ranges (1 tool, 6 ops) - Parameters and configuration
- 📁 Files (1 tool, 6 ops) - Session management and workbook creation
- 🎨 Conditional Formatting (1 tool, 2 ops) - Rules and clearing
📚 Complete Feature Reference →
💬 Example Prompts
Data Transformation & Analysis:
- "Optimize all my Power Queries in this workbook for better performance"
- "Create a PivotTable from SalesData table showing top 10 products by region with sum and average"
- "Create a data model from the following tables ... "
- "Build a DAX measure calculating year-over-year growth with proper time intelligence"
- "Filter this table by Column Product = Sushi"
- *"Create a treemap chart from this table".
Formatting & Styling (No Programming Required):
- "Format the revenue columns as currency, make headers bold with blue background, and add borders to the table"
- "Apply conditional formatting to highlight values above $10,000 in red and below $5,000 in yellow"
- "Convert this data range to an Excel Table with style TableStyleMedium2, add auto-filters, and create a totals row"
Workflow Automation:
- "Find all cells containing 'Q1 2024' and replace with 'Q1 2025', then sort the table by Date descending"
- "Add data validation dropdowns to the Status column with options: Active, Pending, Completed"
- "Merge the header cells, center-align them, and auto-fit all column widths to content"
Quick Start
- Install this extension (you just did!)
- Ask Copilot in the chat panel:
- "List all Power Query queries in workbook.xlsx"
- "Create a DAX measure for year-over-year revenue growth"
- "Export all Powere Queires and VBA modules to .vba files for version control"
That's it! The extension automatically installs .NET 10 runtime and includes a bundled MCP server.
➡️ Learn more and see examples
Requirements
- Windows OS - Excel COM automation requires Windows
- Microsoft Excel 2016+ - Must be installed on your system
- .NET 10 Runtime - Automatically installed by the extension
Potential Issues
"Excel is not installed" error:
- Ensure Microsoft Excel 2016+ is installed on your Windows machine
- Try opening Excel manually to verify it works
"VBA access denied" error:
- VBA operations require one-time manual setup in Excel
- Go to: File → Options → Trust Center → Trust Center Settings → Macro Settings
- Check "Trust access to the VBA project object model"
Copilot doesn't see Excel tools:
-
Restart VS Code after installing the extension
-
Troubleshooting
-
Check Output panel → "Excel MCP Server" for connection status
Documentation & Support
- Complete Documentation - Full guides and examples
- Report Issues - Bug reports and feature requests
License
MIT License - see LICENSE
Built with GitHub Copilot | Powered by Model Context Protocol