Excel MCP Server

Excel MCP Server

Um servidor MCP (Model Context Protocol) que lê e escreve dados do MS Excel.

Recursos

• Ler/Escrever valores de texto
• Ler/Escrever fórmulas
• Criar novas planilhas

🪟Somente Windows:

• Edição ao vivo
• Capturar imagem da tela de uma planilha

Para mais detalhes, consulte a seção ferramentas.

Requisitos

• Node.js 20.x ou posterior

Formatos de arquivo suportados

• xlsx (pasta de trabalho do Excel)
• xlsm (pasta de trabalho do Excel habilitada para macros)
• xltx (modelo do Excel)
• xltm (modelo do Excel habilitado para macros)

Instalação

Instalação via NPM

excel-mcp-server é instalado automaticamente ao adicionar a seguinte configuração à configuração dos servidores MCP.

Para Windows:

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

Para outras plataformas:

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

Instalação via Smithery

Para instalar o Excel MCP Server para Claude Desktop automaticamente via Smithery:

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

Ferramentas

excel_describe_sheets

Lista todas as informações das planilhas do arquivo Excel especificado.

Argumentos:

• fileAbsolutePath
  • Caminho absoluto para o arquivo Excel

excel_read_sheet

Lê valores da planilha do Excel com paginação.

Argumentos:

• fileAbsolutePath
  • Caminho absoluto para o arquivo Excel
• sheetName
  • Nome da planilha no arquivo Excel
• range
  • Intervalo de células a serem lidas na planilha do Excel (ex.: "A1:C10"). [padrão: primeiro intervalo de paginação]
• showFormula
  • Mostrar fórmula em vez de valor [padrão: false]
• showStyle
  • Mostrar informações de estilo das células [padrão: false]

excel_screen_capture

[Somente Windows] Tira uma captura de tela da planilha do Excel com paginação.

Argumentos:

• fileAbsolutePath
  • Caminho absoluto para o arquivo Excel
• sheetName
  • Nome da planilha no arquivo Excel
• range
  • Intervalo de células a serem lidas na planilha do Excel (ex.: "A1:C10"). [padrão: primeiro intervalo de paginação]

excel_write_to_sheet

Escreve valores na planilha do Excel.

Argumentos:

• fileAbsolutePath
  • Caminho absoluto para o arquivo Excel
• sheetName
  • Nome da planilha no arquivo Excel
• newSheet
  • Criar uma nova planilha se verdadeiro, caso contrário, escrever na planilha existente
• range
  • Intervalo de células a serem lidas na planilha do Excel (ex.: "A1:C10").
• values
  • Valores a serem escritos na planilha do Excel. Se o valor for uma fórmula, deve começar com "="

excel_create_table

Cria uma tabela na planilha do Excel

Argumentos:

• fileAbsolutePath
  • Caminho absoluto para o arquivo Excel
• sheetName
  • Nome da planilha onde a tabela é criada
• range
  • Intervalo a ser transformado em tabela (ex.: "A1:C10")
• tableName
  • Nome da tabela a ser criada

excel_copy_sheet

Copia uma planilha existente para uma nova planilha

Argumentos:

• fileAbsolutePath
  • Caminho absoluto para o arquivo Excel
• srcSheetName
  • Nome da planilha de origem no arquivo Excel
• dstSheetName
  • Nome da planilha a ser copiada

excel_format_range

Formata células na planilha do Excel com informações de estilo

Argumentos:

• fileAbsolutePath
  • Caminho absoluto para o arquivo Excel
• sheetName
  • Nome da planilha no arquivo Excel
• range
  • Intervalo de células na planilha do Excel (ex.: "A1:C3")
• styles
  • Matriz 2D de objetos de estilo para cada célula. Se uma célula não mudar de estilo, use null. O número de itens da matriz deve corresponder ao tamanho do intervalo.
  • Propriedades do objeto de estilo:
    • border: Matriz de estilos de borda (tipo, cor, estilo)
    • font: Estilo de fonte (negrito, itálico, sublinhado, tamanho, tachado, cor, vertAlign)
    • fill: Estilo de preenchimento/fundo (tipo, padrão, cor, sombreamento)
    • numFmt: String de formato de número personalizado
    • decimalPlaces: Número de casas decimais (0-30)

Configuração

Você pode alterar os comportamentos do servidor MCP através das seguintes variáveis de ambiente:

EXCEL_MCP_PAGING_CELLS_LIMIT

O número máximo de células a serem lidas em uma única operação de paginação.
[padrão: 4000]

Licença

Copyright (c) 2025 Kazuki Negoro

excel-mcp-server é distribuído sob a Licença MIT