Excel/CSV MCP Server

Excel MCP Server

Servidor MCP que dá ao Claude poder total de leitura, escrita e análise sobre arquivos Excel e CSV. 37 ferramentas — desde leituras básicas de células até modelagem financeira.

Instalação

Opção 1: npm (Recomendado)

npm install -g excel-csv-mcp-server

Em seguida, adicione ao seu cliente MCP:

Claude Code:

claude mcp remove excel-csv  # if previously added
claude mcp add excel-csv --transport stdio excel-csv-mcp-server

Claude Desktop / Cursor — adicione à sua configuração MCP (claude_desktop_config.json ou do Cursor mcp.json):

{
  "mcpServers": {
    "excel-csv": {
      "command": "excel-csv-mcp-server"
    }
  }
}

Opção 2: npx (Sem instalação)

Nenhuma instalação global necessária — executa diretamente:

Claude Code:

claude mcp add excel-csv stdio npx -- excel-csv-mcp-server

Claude Desktop / Cursor:

{
  "mcpServers": {
    "excel-csv": {
      "command": "npx",
      "args": ["-y", "excel-csv-mcp-server"]
    }
  }
}

Opção 3: A partir do código-fonte

git clone https://github.com/ishayoyo/excel-mcp.git
cd excel-mcp
npm install
npm run build

Claude Code:

claude mcp add excel-csv stdio node /path/to/excel-mcp/dist/index.js

Claude Desktop / Cursor:

{
  "mcpServers": {
    "excel-csv": {
      "command": "node",
      "args": ["/path/to/excel-mcp/dist/index.js"]
    }
  }
}

O que ele pode fazer

Categoria	Ferramentas	Exemplos
Ler e Navegar	read_file, get_cell, get_range, get_headers, search, filter_rows, aggregate	Ler arquivos, pesquisar valores, filtrar linhas, somar colunas
Arquivos Grandes	read_file_chunked, get_file_info	Transmitir arquivos de 100MB+ em partes
Escrever e Formatar	write_file, add_sheet, write_multi_sheet, export_analysis, format_cells, auto_fit_columns	Criar Excel/CSV, múltiplas planilhas com fórmulas, estilizar células
Análises	statistical_analysis, correlation_analysis, data_profile, pivot_table	Estatísticas, correlações, perfil, tabelas dinâmicas
Financeiro	dcf_analysis, budget_variance_analysis, ratio_analysis, scenario_modeling, trend_analysis	Avaliação DCF, orçamento vs real, índices financeiros, cenários hipotéticos
Limpeza de Dados	find_duplicates, data_cleaner, vlookup_helper	Remover duplicatas, corrigir datas/telefones/nomes, consultas entre arquivos
Operações em Lote	bulk_aggregate_multi_files, bulk_filter_multi_files	Agregar/filtrar em vários arquivos
Validação	validate_data_consistency	Verificações de integridade referencial entre arquivos
Com IA	evaluate_formula, parse_natural_language, explain_formula, smart_data_analysis, ai_provider_status	Avaliar fórmulas, linguagem natural para fórmula, análise de IA

Provedores de IA (Opcional)

Para ferramentas com IA (parse_natural_language, explain_formula, smart_data_analysis), crie um arquivo .env:

cp .env.example .env

ANTHROPIC_API_KEY=your-key
OPENAI_API_KEY=your-key
DEEPSEEK_API_KEY=your-key
GEMINI_API_KEY=your-key

Qualquer provedor único é suficiente. Um fallback local funciona sem nenhuma chave.

Licença

MIT