Repository files navigation

A Model Context Protocol (MCP) server that lets you manipulate Excel files without needing Microsoft Excel installed. Create, read, and modify Excel workbooks with your AI agent.

• 📊 Create and modify Excel workbooks
• 📝 Read and write data
• 🎨 Apply formatting and styles
• 📈 Create charts and visualizations
• 📊 Generate pivot tables
• 🔄 Manage worksheets and ranges

• Python 3.10 or higher

1. Clone the repository:

git clone https://github.com/haris-musa/excel-mcp-server.gitcd excel-mcp-server

2. Install using uv:

uv pip install -e.

Start the server (default port 8000):

uv run excel-mcp-server

Custom port (e.g., 8080):

# Bash/Linux/macOSexport FASTMCP_PORT=8080&& uv run excel-mcp-server# Windows PowerShell$env:FASTMCP_PORT ="8080"; uv run excel-mcp-server

1. Add this configuration to Cursor:

{"mcpServers": {"excel": {"url":"http://localhost:8000/sse","env": {"EXCEL_FILES_PATH":"/path/to/excel/files"      }    }  }}

2. The Excel tools will be available through your AI assistant.

This server uses Server-Sent Events (SSE) transport protocol. For different use cases:

1. Using with Claude Desktop (requires stdio):

   • UseSupergateway to convert SSE to stdio:

2. Hosting Your MCP Server:

   • Remote MCP Server Guide

• FASTMCP_PORT: Server port (default: 8000)
• EXCEL_FILES_PATH: Directory for Excel files (default:./excel_files)

The server provides a comprehensive set of Excel manipulation tools. SeeTOOLS.md for complete documentation of all available tools.

MIT License - seeLICENSE for details.