Skip to main content
Glama
Excel MCP Server
by negokaz

Servidor Excel MCP

Versión NPM insignia de herrería

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

Características

  • Leer/escribir valores de texto

  • Fórmulas de lectura y escritura

  • Crear nuevas hojas

Solo para Windows:

  • Edición en vivo

  • Capturar la imagen de la pantalla desde una hoja

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

Related MCP server: MCP Sheet Parser

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

excel_describe_sheets

Enumere toda la información de la hoja del archivo Excel especificado.

Argumentos:

  • fileAbsolutePath

    • Ruta absoluta al archivo Excel

excel_read_sheet

Leer valores 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

  • showFormula

    • Mostrar fórmula en lugar de valor

excel_screen_capture

[Solo Windows] Tome una captura de pantalla de 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

excel_write_to_sheet

Escribe valores en la hoja de Excel.

Argumentos:

  • fileAbsolutePath

    • Ruta absoluta al archivo Excel

  • sheetName

    • Nombre de la hoja en el archivo Excel

  • newSheet

    • Crea una nueva hoja si es verdadero, de lo contrario escribe en la hoja existente

  • range

    • Rango de celdas a leer en la hoja de Excel (por ejemplo, "A1:C10").

  • values

    • Valores para escribir en la hoja de Excel. Si el valor es una fórmula, debe empezar con "=".

excel_create_table

Crear una tabla en la hoja de Excel

Argumentos:

  • fileAbsolutePath

    • Ruta absoluta al archivo Excel

  • sheetName

    • Nombre de la hoja donde se crea la tabla

  • range

    • Rango que será una tabla (por ejemplo, "A1:C10")

  • tableName

    • Nombre de la tabla que se va a crear

excel_copy_sheet

Copiar una hoja existente a una nueva hoja

Argumentos:

  • fileAbsolutePath

    • Ruta absoluta al archivo Excel

  • srcSheetName

    • Nombre de la hoja fuente en el archivo Excel

  • dstSheetName

    • Nombre de la hoja a copiar

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

Available Tools

6 tools
excel_copy_sheetB
Destructive

Copy existing sheet to a new sheet

Inputs: dstSheetName (required), fileAbsolutePath (required), srcSheetName (required).

excel_create_tableA
Destructive

Create a table in the Excel sheet

Inputs: fileAbsolutePath (required), sheetName (required), tableName (required), range.

excel_describe_sheetsB
Destructive

List all sheet information of specified Excel file

Inputs: fileAbsolutePath (required).

excel_format_rangeB
Destructive

Format cells in the Excel sheet with style information

Inputs: fileAbsolutePath (required), range (required), sheetName (required), styles (required).

excel_read_sheetB
Destructive

Read values from Excel sheet with pagination.

Inputs: fileAbsolutePath (required), sheetName (required), range, showFormula, +1 more.

excel_write_to_sheetC
Destructive

Write values to the Excel sheet

Inputs: fileAbsolutePath (required), newSheet (required), range (required), sheetName (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific Excel operations: copying sheets, creating tables, describing sheets, formatting ranges, reading data, and writing data. There is no overlap or ambiguity between these functions, making tool selection straightforward for an agent.

    Naming Consistency5/5

    All tool names follow a consistent 'excel_verb_noun' pattern (e.g., excel_copy_sheet, excel_create_table), using snake_case throughout. This predictable naming convention enhances readability and reduces cognitive load for agents.

    Tool Count4/5

    With 6 tools, the server is well-scoped for basic Excel operations, covering key tasks like reading, writing, formatting, and sheet management. It could benefit from additional tools for advanced features (e.g., formulas, charts), but the current set is reasonable and focused.

    Completeness4/5

    The tools provide solid coverage for core Excel workflows: reading and writing data, sheet management, formatting, and table creation. Minor gaps exist, such as lacking tools for formulas, charts, or cell manipulation (e.g., delete, merge), but agents can handle common tasks effectively with this surface.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server designed for AI assistants to directly process spreadsheet files, enabling them to read, display, modify, and save various table formats like CSV and Excel.
      3
      3
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI agents to freely operate Excel spreadsheets, providing tools for workbook creation, cell manipulation, formatting, formula handling, and data export.
      11
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to automate Microsoft Excel tasks such as reading/writing cells, formatting, creating charts, and managing sheets through natural language using the Model Context Protocol.
      1
      Apache 2.0