Excel MCP

haris-musa/excel-mcp-server· Проверено 12.11.2026· 4,3 тыс.на GitHub

Даёт агенту создавать и править файлы Excel: таблицы, формулы, диаграммы, сводные таблицы, срезы и условное форматирование. Сам Microsoft Excel для этого не нужен.

Работает с файлами .xlsx, .xlsm, .xltx и .xltm через openpyxl на любой системе; формулы считает встроенный движок на 479 функций.

Как подключить

Что сделать до подключения

1

Менеджер пакетов uv

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio excel \
  -- uvx excel-mcp-server stdio --allow-dir '<папка с книгами>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Инструменты сервера

describe_workbookописывает книгу
describe_sheetописывает лист
read_rangeчитает диапазон с посчитанными формулами
write_rangeпишет значения и формулы
create_workbookсоздаёт книгу
create_sheetдобавляет лист
sort_rangeсортирует диапазон
find_cellsищет ячейки
replace_cellsзаменяет текст в ячейках
trace_formulaразбирает, откуда берётся число
goal_seekподбирает параметр под результат
format_rangeменяет шрифты, заливку, форматы чисел
add_conditional_formatдобавляет условное форматирование
add_data_validationдобавляет выпадающие списки и ограничения
set_tableоформляет диапазон таблицей
create_chartстроит диаграмму
create_pivot_tableсоздаёт сводную таблицу
add_slicerдобавляет срез
import_csvзагружает CSV на лист
read_vbaчитает код макросов

Показано 20 из 46.

Что попросить агента

«Что лежит в <reports/q1.xlsx>? Опиши листы и покажи первые строки»Опишет книгу и листы через describe_workbook и describe_sheet, прочитает диапазон через read_range
«Откуда в <Итог!B12> берётся это число?»Разберёт цепочку ссылок через trace_formula
«Какой должна быть цена в <B3>, чтобы прибыль в <B10> стала <500 000>?»Подберёт значение через goal_seek
«Загрузи <sales.csv> на новый лист и сделай сводную по менеджерам и месяцам»Загрузит файл через import_csv и построит сводную через create_pivot_table, при желании добавит срез через add_slicer
«Подсвети красным строки, где остаток меньше нуля, и добавь диаграмму по месяцам»Добавит условное форматирование через add_conditional_format и диаграмму через create_chart

Для каких задач

Построить диаграмму, в том числе каскадную, гистограмму, Парето или воронку
Собрать сводную таблицу с группировкой и вычисляемыми полями и повесить на неё срез
Найти, почему число в отчёте неверное: проследить влияющие и зависимые ячейки и вычислить формулу по шагам
Подобрать значение входа под нужный результат формулы
Загрузить CSV на лист и выгрузить диапазон обратно в CSV
Разметить таблицу условным форматированием и выпадающими списками

Ограничения

!

Макросы сервер никогда не запускает. Запись VBA включается только флагом --allow-vba-write; подписанные VBA-проекты сервер отклоняет

!

Формулы с выходом в сеть или к другим программам (WEBSERVICE, IMAGE, RTD, CALL), макрофункции Excel 4.0, DDE-ссылки и ссылки на другие книги отклоняются

!

Один вызов обрабатывает до 100 000 ячеек, книги больше 100 МБ сервер не открывает; пределы меняются флагами --max-cells и --max-file-mb

!

Цепочки комментариев, фигуры и элементы форм сервер сохраняет как есть, но править их не умеет

Если не работает

Десктопный клиент не находит uvx
Приложение не видит PATH вашей оболочки, чаще на macOS: впишите полный путь к uvx, его выводит which uvx.
read_range вернул null вместо результата формулы
Встроенный калькулятор не смог посчитать формулу так же, как Excel; причина указана в списке uncalculated, а Excel посчитает формулу при открытии файла.
write_range сообщает о #SPILL!
Формула с несколькими значениями упирается в занятую ячейку: освободите ячейки рядом с формулой.
После обновления до 2.0 сохранённые запросы и клиенты ссылаются на несуществующие инструменты
В 2.0 переименованы инструменты и параметры: сверьтесь с таблицей Upgrading from 1.x в CHANGELOG.

Частые вопросы

Нужен ли установленный Excel?
Нет: сервер работает с файлами через openpyxl, а формулы считает своим движком. read_range возвращает значения даже для файлов, которые ни разу не открывали в Excel.
Как ограничить, какие файлы видит агент?
Флаг --allow-dir открывает только книги внутри указанной папки и её подпапок, флаг можно повторить. Без него подходит любой абсолютный путь к файлу Excel, но существующую книгу сервер молча не перезапишет.
Можно дать агенту только читать?
Да: флаг --read-only или EXCEL_MCP_READ_ONLY=1 оставляет только инструменты, которые не меняют файлы.
Как сэкономить контекст?
Флаг --tools оставляет базовые describe_workbook, describe_sheet и read_range и только нужные группы, например --tools data,charts.
Можно подключиться к серверу по сети?
Да, режим streamable-http слушает http://127.0.0.1:8017/mcp. Для доступа с других машин задайте EXCEL_MCP_AUTH_TOKEN и --host; клиенты шлют заголовок Authorization: Bearer с этим токеном.
Работает ли сервер из России?
Сервер работает на вашем компьютере, ключи и аккаунт Microsoft не нужны.

Похожие серверы