Excel MCP Server

Leer y escribir datos de archivos de Microsoft Excel. Admite texto, fórmulas, creación de hojas y edición en vivo solo para Windows.

GitHub

Prueba este MCPPatrocinado

Documentación

Excel MCP Server

Un servidor de Protocolo de Contexto de Modelo (MCP) que lee y escribe datos de MS Excel.

Características

Leer/Escribir valores de texto
Leer/Escribir fórmulas
Crear nuevas hojas

🪟Solo Windows:

Edición en vivo
Capturar imagen de pantalla de una hoja

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

Requisitos

Node.js 20.x o posterior

Formatos de archivo compatibles

xlsx (libro de Excel)
xlsm (libro de Excel con macros)
xltx (plantilla de Excel)
xltm (plantilla de Excel con macros)

Instalación

Instalación mediante NPM

excel-mcp-server se instala automáticamente añadiendo la siguiente configuración a la configuración de 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 Smithery

Para instalar Excel MCP Server para Claude Desktop automáticamente mediante Smithery:

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

Herramientas

`excel_describe_sheets`

Lista toda la información de hojas del archivo de Excel especificado.

Argumentos:

fileAbsolutePath
- Ruta absoluta al archivo de Excel

`excel_read_sheet`

Lee valores de la hoja de Excel con paginación.

Argumentos:

fileAbsolutePath
- Ruta absoluta al archivo de Excel
sheetName
- Nombre de la hoja en el archivo de Excel
range
- Rango de celdas a leer en la hoja de Excel (p. ej., "A1:C10"). [predeterminado: primer rango de paginación]
showFormula
- Mostrar fórmula en lugar del valor [predeterminado: false]
showStyle
- Mostrar información de estilo para las celdas [predeterminado: false]

`excel_screen_capture`

[Solo Windows] Toma una captura de pantalla de la hoja de Excel con paginación.

Argumentos:

fileAbsolutePath
- Ruta absoluta al archivo de Excel
sheetName
- Nombre de la hoja en el archivo de Excel
range
- Rango de celdas a leer en la hoja de Excel (p. ej., "A1:C10"). [predeterminado: primer rango de paginación]

`excel_write_to_sheet`

Escribe valores en la hoja de Excel.

Argumentos:

fileAbsolutePath
- Ruta absoluta al archivo de Excel
sheetName
- Nombre de la hoja en el archivo de Excel
newSheet
- Crear una nueva hoja si es true, de lo contrario escribir en la hoja existente
range
- Rango de celdas a leer en la hoja de Excel (p. ej., "A1:C10").
values
- Valores a escribir en la hoja de Excel. Si el valor es una fórmula, debe comenzar con "="

`excel_create_table`

Crea una tabla en la hoja de Excel

Argumentos:

fileAbsolutePath
- Ruta absoluta al archivo de Excel
sheetName
- Nombre de la hoja donde se crea la tabla
range
- Rango para ser una tabla (p. ej., "A1:C10")
tableName
- Nombre de la tabla a crear

`excel_copy_sheet`

Copia la hoja existente a una nueva hoja

Argumentos:

fileAbsolutePath
- Ruta absoluta al archivo de Excel
srcSheetName
- Nombre de la hoja de origen en el archivo de Excel
dstSheetName
- Nombre de la hoja a copiar

`excel_format_range`

Formatea celdas en la hoja de Excel con información de estilo

Argumentos:

fileAbsolutePath
- Ruta absoluta al archivo de Excel
sheetName
- Nombre de la hoja en el archivo de Excel
range
- Rango de celdas en la hoja de Excel (p. ej., "A1:C3")
styles
- Matriz 2D de objetos de estilo para cada celda. Si una celda no cambia de estilo, use null. El número de elementos de la matriz debe coincidir con el tamaño del rango.
- Propiedades del objeto de estilo:
  - border: Matriz de estilos de borde (tipo, color, estilo)
  - font: Estilo de fuente (negrita, cursiva, subrayado, tamaño, tachado, color, vertAlign)
  - fill: Estilo de relleno/fondo (tipo, patrón, color, sombreado)
  - numFmt: Cadena de formato de número personalizado
  - decimalPlaces: Número de decimales (0-30)

Configuración

Puede cambiar los comportamientos 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

excel-mcp-server se publica bajo la Licencia MIT