Excel MCP Server

MIT License
1,658
68
  • Linux
  • Apple

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Servidor Excel MCP

Un servidor de Protocolo de contexto de modelo (MCP) que lee y escribe datos de MS Excel.

Características

  • Leer valores de texto de un archivo MS Excel
  • Escribir valores de texto en un archivo MS Excel
  • Leer fórmulas de un archivo MS Excel
  • Escribir fórmulas en un archivo MS Excel
  • Capturar la imagen de pantalla desde un archivo MS Excel (solo Windows)

Para más detalles, consulte la sección de herramientas .

Requisitos

  • Node.js 20.x o posterior

Formatos de archivo compatibles

  • xlsx (libro de Excel)
  • xlsm (libro de Excel con macros habilitadas)
  • xltx (plantilla de Excel)
  • xltm (plantilla de Excel habilitada para macros)

Instalación

Instalación mediante NPM

excel-mcp-server se instala automáticamente agregando la siguiente configuración a la configuración de los servidores MCP.

Para Windows:

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

Para otras plataformas:

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

Instalación mediante herrería

Para instalar Excel MCP Server para Claude Desktop automáticamente a través de Smithery :

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

read_sheet_names

Enumere todos los nombres de hojas en un archivo Excel.

Argumentos:

  • fileAbsolutePath
    • Ruta absoluta al archivo Excel

read_sheet_data

Leer datos de una hoja de Excel con paginación.

Argumentos:

  • fileAbsolutePath
    • Ruta absoluta al archivo Excel
  • sheetName
    • Nombre de la hoja en el archivo Excel
  • range
    • Rango de celdas para leer en la hoja de Excel (p. ej., "A1:C10"). [predeterminado: primer rango de paginación]
  • knownPagingRanges
    • Lista de rangos de paginación ya leídos

read_sheet_formula

Leer fórmulas de una hoja de Excel con paginación.

Argumentos:

  • fileAbsolutePath
    • Ruta absoluta al archivo Excel
  • sheetName
    • Nombre de la hoja en el archivo Excel
  • range
    • Rango de celdas para leer en la hoja de Excel (p. ej., "A1:C10"). [predeterminado: primer rango de paginación]
  • knownPagingRanges
    • Lista de rangos de paginación ya leídos

read_sheet_image

[Solo Windows] Leer datos como una imagen desde la hoja de Excel con paginación.

Argumentos:

  • fileAbsolutePath
    • Ruta absoluta al archivo Excel
  • sheetName
    • Nombre de la hoja en el archivo Excel
  • range
    • Rango de celdas para leer en la hoja de Excel (p. ej., "A1:C10"). [predeterminado: primer rango de paginación]
  • knownPagingRanges
    • Lista de rangos de paginación ya leídos

write_sheet_data

Escribir datos en la hoja de Excel.

Argumentos:

  • fileAbsolutePath
    • Ruta absoluta al archivo Excel
  • sheetName
    • Nombre de la hoja en el archivo Excel
  • range
    • Rango de celdas a leer en la hoja de Excel (por ejemplo, "A1:C10").
  • data
    • Datos para escribir en la hoja de Excel

write_sheet_formula

Escribe fórmulas en la hoja de Excel.

Argumentos:

  • fileAbsolutePath
    • Ruta absoluta al archivo Excel
  • sheetName
    • Nombre de la hoja en el archivo Excel
  • range
    • Rango de celdas a leer en la hoja de Excel (por ejemplo, "A1:C10").
  • formulas
    • Fórmulas para escribir en la hoja de Excel (p. ej., "=A1+B1")

Puede cambiar el comportamiento del servidor MCP mediante las siguientes variables de entorno:

EXCEL_MCP_PAGING_CELLS_LIMIT

El número máximo de celdas a leer en una sola operación de paginación.
[predeterminado: 4000]

Licencia

Copyright (c) 2025 Kazuki Negoro

excel-mcp-server se publica bajo la licencia MIT

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA leer y escribir en archivos de Microsoft Excel, admitiendo formatos como xlsx, xlsm, xltx y xltm.

  1. Features
    1. Requirements
      1. Supported file formats
        1. Installation
          1. Installing via NPM
          2. Installing via Smithery
          3. read_sheet_names
          4. read_sheet_data
          5. read_sheet_formula
          6. read_sheet_image
          7. write_sheet_data
          8. write_sheet_formula
          9. EXCEL_MCP_PAGING_CELLS_LIMIT
        2. License
          ID: hklvuq4p5r