Skip to content
Back to search

excel-mcp-server

A Model Context Protocol (MCP) server that reads and writes MS Excel data

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/negokaz--excel-mcp-server/badge.svg)](/listings/negokaz--excel-mcp-server)

HTML

<a href="/listings/negokaz--excel-mcp-server"><img src="/api/listings/negokaz--excel-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Installing via NPM

excel-mcp-server is automatically installed by adding the following configuration to the MCP servers configuration.

For Windows:

{
    "mcpServers": {
        "excel": {
            "command": "cmd",
            "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

For other platforms:

{
    "mcpServers": {
        "excel": {
            "command": "npx",
            "args": ["--yes", "@negokaz/excel-mcp-server"],
            "env": {
                "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
            }
        }
    }
}

Installing via Smithery

To install Excel MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@negokaz/excel-mcp-server):

npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude

<h2 id="tools">Tools</h2>

`excel_describe_sheets`

List all sheet information of specified Excel file.

**Arguments:** - `fileAbsolutePath` - Absolute path to the Excel file

`excel_read_sheet`

Read values from Excel sheet with pagination.

**Arguments:** - `fileAbsolutePath` - Absolute path to the Excel file - `sheetName` - Sheet name in the Excel file - `range` - Range of cells to read in the Excel sheet (e.g., "A1:C10"). [default: first paging range] - `showFormula` - Show formula instead of value [default: false] - `showStyle` - Show style information for cells [default: false]

`excel_screen_capture`

**[Windows only]** Take a screenshot of the Excel sheet with pagination.

**Arguments:** - `fileAbsolutePath` - Absolute path to the Excel file - `sheetName` - Sheet name in the Excel file - `range` - Range of cells to read in the Excel sheet (e.g., "A1:C10"). [default: first paging range]

`excel_write_to_sheet`

Write values to the Excel sheet.

**Arguments:** - `fileAbsolutePath` - Absolute path to the Excel file - `sheetName` - Sheet name in the Excel file - `newSheet` - Create a new sheet if true, otherwise write to the existing sheet - `range` - Range of cells to read in the Excel sheet (e.g., "A1:C10"). - `values` - Values to write to the Excel sheet. If the value is a formula, it should start with "="

`excel_create_table`

Create a table in the Excel sheet

**Arguments:** - `fileAbsolutePath` - Absolute path to the Excel file - `sheetName` - Sheet name where the table is created - `range` - Range to be a table (e.g., "A1:C10") - `tableName` - Table name to be created

`excel_copy_sheet`

Copy existing sheet to a new sheet

**Arguments:** - `fileAbsolutePath` - Absolute path to the Excel file - `srcSheetName` - Source sheet name in the Excel file - `dstSheetName` - Sheet name to be copied

`excel_format_range`

Format cells in the Excel sheet with style information

**Arguments:** - `fileAbsolutePath` - Absolute path to the Excel file - `sheetName` - Sheet name in the Excel file - `range` - Range of cells in the Excel sheet (e.g., "A1:C3") - `styles` - 2D array of style objects for each cell. If a cell does not change style, use null. The number of items of the array must match the range size. - Style object properties: - `border`: Array of border styles (type, color, style) - `font`: Font styling (bold, italic, underline, size, strike, color, vertAlign) - `fill`: Fill/background styling (type, pattern, color, shading) - `numFmt`: Custom number format string - `decimalPlaces`: Number of decimal places (0-30)

<h2 id="configuration">Configuration</h2>

You can change the MCP Server behaviors by the following environment variables:

`EXCEL_MCP_PAGING_CELLS_LIMIT`

The maximum number of cells to read in a single paging operation. [default: 4000]

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 194 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Excel MCP Server
  2. <img src="https://github.com/negokaz/excel-mcp-server/blob/main/docs/img/icon-800.png?raw=true" width="128">
  3. <a href="https://glama.ai/mcp/servers/@negokaz/excel-mcp-server">
  4. <img width="380" height="200" src="https://glama.ai/mcp/servers/@negokaz/excel-mcp-server/badge" alt="Excel Server MCP server" />
  5. </a>
  6. [![NPM Version](https://img.shields.io/npm/v/@negokaz/excel-mcp-server)](https://www.npmjs.com/package/@negokaz/excel-mcp-server)
  7. [![smithery badge](https://smithery.ai/badge/@negokaz/excel-mcp-server)](https://smithery.ai/server/@negokaz/excel-mcp-server)
  8. A Model Context Protocol (MCP) server that reads and writes MS Excel data.
  9. ## Features
  10. - Read/Write text values
  11. - Read/Write formulas
  12. - Create new sheets
  13. **🪟Windows only:**
  14. - Live editing
  15. - Capture screen image from a sheet
  16. For more details, see the [tools](#tools) section.
  17. ## Requirements
  18. - Node.js 20.x or later
  19. ## Supported file formats
  20. - xlsx (Excel book)
  21. - xlsm (Excel macro-enabled book)
  22. - xltx (Excel template)
  23. - xltm (Excel macro-enabled template)
  24. ## Installation
  25. ### Installing via NPM
  26. excel-mcp-server is automatically installed by adding the following configuration to the MCP servers configuration.
  27. For Windows:
  28. ```json
  29. {
  30. "mcpServers": {
  31. "excel": {
  32. "command": "cmd",
  33. "args": ["/c", "npx", "--yes", "@negokaz/excel-mcp-server"],
  34. "env": {
  35. "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
  36. }
  37. }
  38. }
  39. }
  40. ```
  41. For other platforms:
  42. ```json
  43. {
  44. "mcpServers": {
  45. "excel": {
  46. "command": "npx",
  47. "args": ["--yes", "@negokaz/excel-mcp-server"],
  48. "env": {
  49. "EXCEL_MCP_PAGING_CELLS_LIMIT": "4000"
  50. }
  51. }
  52. }
  53. }
  54. ```
  55. ### Installing via Smithery
  56. To install Excel MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@negokaz/excel-mcp-server):
  57. ```bash
  58. npx -y @smithery/cli install @negokaz/excel-mcp-server --client claude
  59. ```
  60. <h2 id="tools">Tools</h2>
  61. ### `excel_describe_sheets`
  62. List all sheet information of specified Excel file.
  63. **Arguments:**
  64. - `fileAbsolutePath`
  65. - Absolute path to the Excel file
  66. ### `excel_read_sheet`
  67. Read values from Excel sheet with pagination.
  68. **Arguments:**
  69. - `fileAbsolutePath`
  70. - Absolute path to the Excel file
  71. - `sheetName`
  72. - Sheet name in the Excel file
  73. - `range`
  74. - Range of cells to read in the Excel sheet (e.g., "A1:C10"). [default: first paging range]
  75. - `showFormula`
  76. - Show formula instead of value [default: false]
  77. - `showStyle`
  78. - Show style information for cells [default: false]
  79. ### `excel_screen_capture`
  80. **[Windows only]** Take a screenshot of the Excel sheet with pagination.
  81. **Arguments:**
  82. - `fileAbsolutePath`
  83. - Absolute path to the Excel file
  84. - `sheetName`
  85. - Sheet name in the Excel file
  86. - `range`
  87. - Range of cells to read in the Excel sheet (e.g., "A1:C10"). [default: first paging range]
  88. ### `excel_write_to_sheet`
  89. Write values to the Excel sheet.
  90. **Arguments:**
  91. - `fileAbsolutePath`
  92. - Absolute path to the Excel file
  93. - `sheetName`
  94. - Sheet name in the Excel file
  95. - `newSheet`
  96. - Create a new sheet if true, otherwise write to the existing sheet
  97. - `range`
  98. - Range of cells to read in the Excel sheet (e.g., "A1:C10").
  99. - `values`
  100. - Values to write to the Excel sheet. If the value is a formula, it should start with "="
  101. ### `excel_create_table`
  102. Create a table in the Excel sheet
  103. **Arguments:**
  104. - `fileAbsolutePath`
  105. - Absolute path to the Excel file
  106. - `sheetName`
  107. - Sheet name where the table is created
  108. - `range`
  109. - Range to be a table (e.g., "A1:C10")
  110. - `tableName`
  111. - Table name to be created
  112. ### `excel_copy_sheet`
  113. Copy existing sheet to a new sheet
  114. **Arguments:**
  115. - `fileAbsolutePath`
  116. - Absolute path to the Excel file
  117. - `srcSheetName`
  118. - Source sheet name in the Excel file
  119. - `dstSheetName`
  120. - Sheet name to be copied
  121. ### `excel_format_range`
  122. Format cells in the Excel sheet with style information
  123. **Arguments:**
  124. - `fileAbsolutePath`
  125. - Absolute path to the Excel file
  126. - `sheetName`
  127. - Sheet name in the Excel file
  128. - `range`
  129. - Range of cells in the Excel sheet (e.g., "A1:C3")
  130. - `styles`
  131. - 2D array of style objects for each cell. If a cell does not change style, use null. The number of items of the array must match the range size.
  132. - Style object properties:
  133. - `border`: Array of border styles (type, color, style)
  134. - `font`: Font styling (bold, italic, underline, size, strike, color, vertAlign)
  135. - `fill`: Fill/background styling (type, pattern, color, shading)
  136. - `numFmt`: Custom number format string
  137. - `decimalPlaces`: Number of decimal places (0-30)
  138. <h2 id="configuration">Configuration</h2>
  139. You can change the MCP Server behaviors by the following environment variables:
  140. ### `EXCEL_MCP_PAGING_CELLS_LIMIT`
  141. The maximum number of cells to read in a single paging operation.
  142. [default: 4000]
  143. ## License
  144. Copyright (c) 2025 Kazuki Negoro
  145. excel-mcp-server is released under the [MIT License](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.