Excel MCP Server

Что умеет сервер

Excel MCP Server построен на openpyxl и работает с файлами .xlsx, .xlsm, .xltx и .xltm в Windows, macOS и Linux, устанавливать сам Excel не нужно. Инструменты разбиты на области: книги (create_workbook, describe_workbook), листы, ячейки (read_range, write_range, sort_range, find_cells), формулы (trace_formula, goal_seek), форматирование, объекты (create_chart, create_pivot_table, add_slicer, set_table), имена, примечания и макросы.

Формулы вычисляет встроенный движок примерно на 260 функций, поэтому read_range возвращает значения и для файлов, которые никогда не открывались в Excel. Поддерживаются динамические массивы, условное форматирование, проверка данных, импорт и экспорт CSV, сводные таблицы и срезы. Чтение больших листов идёт постранично, и память остаётся ровной на сотнях тысяч строк.

Когда использовать

Сервер подходит для отчётов и моделей, которые нужно собирать, дополнять и проверять прямо в диалоге: загрузить выгрузку из CSV, посчитать сводные показатели, построить диаграмму, разобраться, почему в ячейке неверное число (trace_formula), подобрать входное значение инструментом goal_seek. Параметр --tools позволяет включить только нужные области и сэкономить контекст, так как каждый инструмент занимает место в запросе.

Ограничения и безопасность

Формулы хранятся в файле, а Excel пересчитывает их при открытии. Если встроенный калькулятор не может воспроизвести формулу, значение возвращается как null с причиной в списке uncalculated, оно не угадывается. Старые файлы .xls не поддерживаются, для CSV есть import_csv.

Защитные механизмы описаны в README: ограничение каталогов флагом --allow-dir, режим --read-only, проверка формул перед записью (отвергаются функции, которые обращаются к сети и другим программам, ссылки на внешние книги), атомарное сохранение без полузаписанных файлов и привязка HTTP-режима только к localhost. Без --allow-dir доступны любые абсолютные пути к файлам Excel, поэтому указывайте рабочую папку явно.

Запись макросов VBA выключена и включается флагом --allow-vba-write. Сервер макросы не запускает, но код выполнится при включении макросов в Excel, так что читайте его перед включением. Содержимое ячеек это данные из файла; сервер просит модель не выполнять найденные там инструкции, но результаты работы с чужими таблицами стоит проверять. Для запуска нужен uv.

Для всех клиентов нужен uv: сервер запускается командой uvx excel-mcp-server stdio. Замените /path/to/workbooks на папку, которую сервер может использовать.

Claude Code

claude mcp add excel --scope user -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Claude Desktop

Скачайте excel-mcp-server.mcpb из последнего релиза репозитория и откройте его, Claude спросит, какую папку разрешить серверу. Либо вручную: Settings, Developer, Edit Config, добавьте блок mcpServers из раздела ниже в claude_desktop_config.json и перезапустите Claude.

Cursor и клиенты с mcpServers

Файл ~/.cursor/mcp.json:

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": ["excel-mcp-server", "stdio", "--allow-dir", "/path/to/workbooks"]
    }
  }
}

VS Code с GitHub Copilot

Файл .vscode/mcp.json (ключ именно servers):

{
  "servers": {
    "excel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["excel-mcp-server", "stdio", "--allow-dir", "${workspaceFolder}"]
    }
  }
}

Codex и Gemini CLI

codex mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks
gemini mcp add -s user excel uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Настольные приложения часто не видят uvx из-за PATH (это обычное дело в macOS): укажите полный путь, который покажет which uvx.