excel-mcp-server MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Criar/ler/atualizar workbooks e planilhas
Fórmulas, tabelas, gráficos (linha/barra/pizza/dispersão), tabelas dinâmicas
Formatação: fontes, cores, bordas, formatação condicional
Modos de transporte: stdio (local) e streamable-http (remoto)
Sem necessidade de instalar Excel/Office — puro Python

Demo ao vivo

Como fica na prática

excel.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "excel",
      "command": "uvx",
      "args": [
        "excel-mcp-server"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "excel": {
      "command": {
        "path": "uvx",
        "args": [
          "excel-mcp-server"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add excel -- uvx excel-mcp-server

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: excel-mcp-server

Como gerar um relatório Excel mensal a partir de um prompt

👤 Ops, finanças, qualquer pessoa enviando Excel para stakeholders não técnicos ⏱ ~20 min intermediate

Quando usar: No fechamento de cada mês quando você atualiza 'a planilha que todos pedem'.

Pré-requisitos

uv instalado — curl -LsSf https://astral.sh/uv/install.sh | sh
Uma fonte de verdade (CSV, consulta de BD ou arquivo do mês anterior) — Exportar para CSV, ou parear com MCP postgres

Fluxo

Criar o workbook

Criar /reports/2026-04.xlsx com abas 'Resumo', 'Receita', 'Custos', 'Gráficos'.✓ Copiado

→ Arquivo criado, planilhas existem
Popular dados

Preencher 'Receita' de /data/apr-revenue.csv; adicionar uma linha de total com fórmulas SUM.✓ Copiado

→ Linhas + totais presentes
Adicionar gráficos

Na aba 'Gráficos' adicionar um gráfico de linha da receita diária de 'Receita' A2:B31 intitulado 'Receita de Abril'.✓ Copiado

→ Gráfico visível ao abrir no Excel
Formatar

Em 'Resumo', negrito nos cabeçalhos, aplicar separadores de milhares à moeda e formatar condicionalmente valores vermelhos (negativos).✓ Copiado

→ Arquivo formatado profissionalmente

Resultado: Um .xlsx pronto para revisão com fórmulas ativas e gráficos.

Armadilhas

Colar 100k linhas via prompt excede a janela de contexto — Ter o MCP ler o CSV diretamente do disco em vez de colar valores
Tabelas dinâmicas escritas por openpyxl não atualizam automaticamente ao abrir em algumas versões do Excel — Instruir usuários a clicar com botão direito em Atualizar; ou usar um resumo baseado em fórmulas em vez disso

Combine com: postgres · filesystem

Como extrair tabelas de um deck Excel para markdown

👤 Engenheiros transformando planilhas financeiras em documentos ⏱ ~10 min beginner

Quando usar: Um stakeholder envia um workbook e você precisa dele em um wiki.

Fluxo

Enumerar planilhas

Abrir /inbox/Q1-plan.xlsx e listar planilhas + dimensões.✓ Copiado

→ Índice de planilhas
Extrair cada uma como markdown

Para cada planilha, ler o intervalo utilizado e renderizar como uma tabela markdown.✓ Copiado

→ Bloco markdown pronto para colar

Resultado: Tabelas prontas para wiki.

Armadilhas

Células mescladas prejudicam a renderização markdown — Desmeiscar antes de exportar, ou lidar com regiões mescladas explicitamente

Combine com: markdownify · notion

Como limpar um arquivo Excel bagunçado em uma única passagem

👤 Profissionais de limpeza de dados ⏱ ~15 min intermediate

Quando usar: Um parceiro envia uma planilha com datas inconsistentes, espaço em branco à direita e cabeçalhos duplicados.

Fluxo

Perfilar os problemas

Auditar /inbox/vendors.xlsx — colunas com tipos mistos, espaço em branco, linhas duplicadas.✓ Copiado

→ Relatório de problemas
Aplicar correções

Remover espaço em branco, analisar coluna E como datas em ISO, remover linhas completamente duplicadas. Salvar em /cleaned/vendors.xlsx.✓ Copiado

→ Arquivo limpo salvo

Resultado: Um workbook limpo pronto para ingestão.

Armadilhas

'Corrigir' datas que eram intencionalmente texto perde o significado — Confirme com o proprietário antes de conversões agressivas

Combine com: postgres

Combinações

Combine com outros MCPs para 10× de alavancagem

excel + postgres

Consultar o BD e escrever o resultado no Excel para stakeholders

Executar SELECT * FROM monthly_revenue WHERE month = '2026-04' e escrever o resultado em /reports/apr.xlsx com um gráfico.✓ Copiado

excel + filesystem

Processar em lote todos os xlsx em uma pasta

Para cada arquivo em /inbox/vendors/, unificar os cabeçalhos para {vendor,sku,qty,price} e escrever em /cleaned/.✓ Copiado

excel + markdownify

Converter tabelas xlsx para documentos markdown

Extrair cada planilha de /inbox/plan.xlsx para seções markdown e escrever /docs/plan.md.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
create_workbook	path: str	Iniciar um novo .xlsx	gratuito
create_worksheet	path, name	Adicionar uma aba	gratuito
write_data_to_excel	path, sheet, start_cell, data: 2d array	Popular um intervalo	gratuito
read_data_from_excel	path, sheet, range	Extrair valores	gratuito
apply_formula	path, sheet, cell, formula	Adicionar uma fórmula	gratuito
create_chart	path, sheet, chart_type, range, title	Inserir um gráfico	gratuito
create_pivot_table	path, source, rows, cols, values	Resumir dados	gratuito
format_range	path, sheet, range, styles	Estilo	gratuito
apply_conditional_formatting	path, sheet, range, rule	Colorir células	gratuito

Custo e limites

O que custa rodar

Cota de API: Nenhuma — tudo local
Tokens por chamada: Depende de quanto dados fluem pelo prompt; prefira operações de caminho de arquivo
Monetário: Gratuito (MIT)
Dica: Ler intervalos, não planilhas inteiras, quando um arquivo tem 100k+ linhas.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Leitura/escrita do sistema de arquivos na pasta contendo os workbooks

Armazenamento de credenciais: Nenhuma

Saída de dados: I/O local apenas; dados saem de sua máquina apenas via seu provedor de LLM

Nunca conceda: Acesso de escrita fora de uma pasta em sandbox ao executar prompts não confiáveis

openpyxl não executa macros ou VBA — a lógica de macro .xlsm é ignorada.
Arquivos muito grandes (>50 MB) podem esgotar a memória em máquinas pequenas.

Solução de problemas

Erros comuns e correções

Permissão negada ao escrever arquivo

Outro programa tem o arquivo aberto (geralmente o Excel). Feche-o e tente novamente.

Verificar: lsof path/to/file.xlsx

Fórmula armazenada como texto

Prefixar strings começando com '=' via apply_formula, não write_data_to_excel.

Gráfico não renderiza no Excel

Verificar se o intervalo de dados cobre as colunas de origem com cabeçalhos; Excel precisa de 2+ linhas.

Arquivo salvo mas Excel diz 'corrompido'

Geralmente misturar write_data e fórmulas na mesma célula. Recriar o arquivo, construir de baixo para cima.

Alternativas

excel-mcp-server vs. outros

Alternativa	Quando usar	Troca
Google Sheets via google-workspace MCP	Você quer planilhas colaborativas em nuvem, não .xlsx local	Precisa de OAuth; não é um substituto para xlsx offline
LibreOffice headless MCP	Você precisa de execução de macro ou conversão para PDF	Instalação pesada; mais lento

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills