convez.ai
MCP ServerAutomaçãoIntermediário
achmadya-dev

MCP Excel Query

achmadya-dev/mcp-excel-query

Acesso programático completo a Excel via MCP com ExcelJS

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para leitura, edição e formatação de arquivos Excel (.xlsx) locais via stdio. Oferece 17 ferramentas para manipular planilhas, incluindo leitura de dados, escrita em lotes, formatação, validação de dados e gerenciamento de abas.

Instalação

$npx convez-ai achmadya-dev/mcp-excel-query

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.3.3
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de relatórios e geração de planilhas dinâmicas
  • Processamento em lote de dados estruturados em Excel
  • Integração de Claude com fluxos baseados em planilhas
  • Leitura e transformação de dados financeiros ou operacionais

Veredito

Ferramenta sólida e bem-documentada para quem precisa de integração robusta entre Claude e arquivos Excel. Cobertura ampla de operações (17 tools) sem suporte a fórmulas server-side, mantendo a arquitetura MCP limpa.

README

A tradução para o português deste README ainda está na fila.

mcp-excel-query

MCP server for local .xlsx files via stdio. TypeScript + ExcelJS.

Install

{
  "mcpServers": {
    "excel": {
      "command": "npx",
      "args": ["-y", "@achmadya-dev/mcp-excel-query"],
      "env": { "EXCEL_PAGING_CELLS_LIMIT": "4000" }
    }
  }
}

Tools (17)

ToolUse for
excel_read_sheetRead JSON rows, formulas (showFormula), styles, dateFormat / dateFormat: "cell", merged cells, validation metadata
excel_get_metadataSheet names, dimensions, dates — use instead of a separate list-sheets tool
excel_create_fileNew workbook + optional headers
excel_write_rangeMain write tool: bulk data, append (append:true), new blank sheet (newSheet:true), single cell/formula (startCell + values), optional style
excel_format_rangeFont, fill, border, alignment, numFmt, merge (mergeCells:true)
excel_copy_sheetDuplicate worksheet
excel_rename_sheetRename worksheet
excel_delete_sheetDelete worksheet
excel_copy_rangeCopy cells to another location
excel_delete_rangeDelete range; shiftDirection: up = rows, left = columns
excel_unmerge_cellsUnmerge range
excel_create_tableNative Excel table
excel_insert_rowsInsert empty rows
excel_insert_columnsInsert empty columns
excel_set_sheet_visibilityShow, hide, or very-hide a sheet
excel_set_data_validationSet or clear dropdown/rules validation on a range
excel_set_dimensionsRow height, column width, sheet defaults

Common patterns

// Append rows
{ "append": true, "values": [[1, "Alice", 25]] }

// Write formula to one cell
{ "startCell": "D2", "values": [["=SUM(A2:C2)"]] }

// New blank sheet
{ "newSheet": true, "sheetName": "Report" }

// Style one cell
{ "startCell": "A1", "values": [["Title"]], "style": { "font": { "bold": true } } }

// Merge + format
{ "startCell": "A1", "endCell": "C1", "mergeCells": true, "bold": true }

// Read dates in human-readable form (uses each cell's Excel numFmt)
{ "range": "H3:H10", "headerRow": 0, "dateFormat": "cell" }

// Write dates as text — auto-parsed to Excel date values
{ "startCell": "H3", "values": [["09 Jun 2026"]] }

// Hide a sheet
{ "sheetName": "Archive", "state": "hidden" }

// Dropdown list validation
{ "startCell": "B2", "endCell": "B100", "type": "list", "formulae": ["\"Yes,No,Maybe\""] }

// Column width and row height
{ "range": "A1:D20", "columnWidth": 18, "rowHeight": 22 }

Notes

  • Formulas are stored, not evaluated server-side.
  • .xlsx only.

Development

pnpm install && pnpm run build && pnpm test
Ver o original no GitHub

Bom para

Relacionados