Excel MCP Server for Cursor: Setup & Config

What you can do with Excel in Cursor

Inspect and change workbook ranges with formulas, tables, and per-cell styles in the same integration.

• Find workbook sheets, then inspect a bounded range before making changes.
• Copy a worksheet or apply per-cell presentation changes.
• Capture a paginated sheet image when working on Windows.

Before you start: Excel in Cursor

• Node.js version 20.x or above
• MCP client able to launch the npm package

The command and flags match the README configuration for other platforms. Its Windows configuration instead launches cmd with /c, then npx and the same package flags. Tool calls use an absolute workbook path. The paging environment key is documented with a default value of 4000.

Excel Cursor configuration

1. Choose Cursor configuration scope

   For Excel MCP Server, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add Excel MCP Server to Cursor

   Use the excel-mcp-server-negokaz entry below in mcpServers. Keep Excel MCP Server's documented stdio connection fields and your other Cursor entries.

3. Check Excel MCP Server in Cursor

   Excel MCP Server: Enable in Cursor’s MCP settings; inspect tools.

{
  "mcpServers": {
    "excel-mcp-server-negokaz": {
      "command": "npx",
      "args": [
        "--yes",
        "@negokaz/excel-mcp-server"
      ],
      "env": {
        "EXCEL_MCP_PAGING_CELLS_LIMIT": "<optional page-size ceiling in cells; documented default is 4000>"
      }
    }
  }
}

Excel tools available to Cursor

Excel's stored tool list documents 7 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

excel_describe_sheets

Find excel_describe_sheets under Excel in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Discover the sheet information associated with a workbook file.

excel_read_sheet

Find excel_read_sheet under Excel in Cursor's MCP settings; inspect its arguments when the agent requests a call.

excel_copy_sheet

Find excel_copy_sheet under Excel in Cursor's MCP settings; inspect its arguments when the agent requests a call.

excel_write_to_sheet

Find excel_write_to_sheet under Excel in Cursor's MCP settings; inspect its arguments when the agent requests a call.

excel_create_table

Find excel_create_table under Excel in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Define a named table over a chosen worksheet range.

excel_format_range

Find excel_format_range under Excel in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Assign styles cell by cell using an array aligned to the selected range.

excel_screen_capture

Find excel_screen_capture under Excel in Cursor's MCP settings; inspect its arguments when the agent requests a call.

On Windows, obtain a paginated screenshot of the requested sheet range.

Excel: full stored tool descriptions

Troubleshooting Excel in Cursor

• Cursor must find npx @negokaz/excel-mcp-server (Node.js/npm) for Excel MCP Server. Enable the project/user entry in MCP settings and inspect its tools.
• Review EXCEL_MCP_PAGING_CELLS_LIMIT for Excel MCP Server before sharing project .cursor/mcp.json; project scope travels with the repository.
• Excel MCP Server uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Screenshot capture and live editing are not documented for non-Windows platforms.
• Known limitation: The npm launch requires Node.js 20.x or a newer release.
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions