엑셀 피벗과차트, AI가파일에 바로
중급자용© AIKOREACLUBharis-musa/excel-mcp-server
엑셀 피벗과 차트, AI가 파일에 바로
클로드, 커서, 코덱스 같은 AI가 엑셀 파일을 직접 열어 피벗 테이블, 차트, 수식, 조건부 서식을 만들고 고치게 해 주는 연결 도구(MCP 서버)예요. 엑셀 프로그램이 없어도 돼요
월말마다 매출 표를 지역별, 분기별로 묶어 차트까지 붙이는 일. AI 채팅에 물으면 "삽입 메뉴에서 피벗 테이블을 누르고, 행에 지역을 끌어다 놓으세요" 같은 설명이 돌아와요. 설명은 친절한데, 클릭은 결국 내가 해야 하죠.excel-mcp-server는 AI가 그 파일을 직접 열어 피벗 테이블과 차트를 만들어 넣게 이어 주는 도구예요. 엑셀을 열지 않은 파일도 수식 값을 계산해 읽고, 숫자가 왜 틀렸는지 수식을 거슬러 따라가요. 최신판 2.2.6이 2026-10-31에 나왔어요.
말로 듣는 엑셀, 파일에 바로 생기는 엑셀
- Data 시트에서 A1:E200 을 고르세요
- 삽입 메뉴에서 피벗 테이블을 누르세요
- 행에 지역, 열에 분기를 끌어 놓으세요
- 값에 매출을 넣고 합계로 바꾸세요
- 피벗을 고른 뒤 삽입에서 세로 막대 차트를 누르세요
README와 TOOLS.md의 도구 이름과 순서를 이해하기 쉽게 저희가 지어낸 매출 표로 그린 예시예요. 실제로 어떤 도구를 부를지와 결과 위치는 AI 도구와 파일에 따라 달라요.
한눈에
무엇인가요
MCP는 AI가 바깥 도구를 불러 쓰게 이어 주는 표준 연결 방식이에요. 이 서버를 연결하면 AI가 엑셀 파일을 다루는 도구 46개를 쓸 수 있어요.만들기. 세로 막대, 꺾은선, 원형부터 폭포, 파레토, 트리맵 같은 엑셀 2016 차트까지 그려요. 피벗 테이블은 엑셀에서 새로 고칠 수 있는 진짜 피벗으로 만들고, 슬라이서와 시간 막대, 셀 안의 작은 차트(스파크라인)도 붙여요.계산과 추적. 함수 약 260개를 계산하는 엔진이 들어 있어서, 엑셀로 한 번도 열지 않은 파일도 수식 결과를 읽어요. 어떤 칸이 이 숫자에 영향을 주는지 시트를 넘나들며 따라가고, 수식을 한 단계씩 풀어 보여 주고, 원하는 결과가 나올 때까지 입력값을 바꿔 보는 목표값 찾기도 해요.정리. 조건부 서식, 드롭다운 목록, 정렬, 필터, 중복 제거, 텍스트 나누기, CSV 가져오기를 해요.엑셀 프로그램 없이 파이썬(openpyxl) 위에서 돌아서 윈도우, 맥, 리눅스 어디서나 써요.
함께 쓰는 도구 · 클로드 데스크톱 · 클로드 코드 · 커서 · VS Code 코파일럿 · 코덱스 · 제미나이 CLI
이런 분께
- 매달 같은 매출, 비용 표를 묶고 차트로 만드는 일을 AI에게 넘기고 싶은 실무자
- 남이 만든 엑셀에서 숫자가 왜 이렇게 나왔는지 수식을 거슬러 확인해야 하는 분
- 클로드 코드나 커서로 보고서 파일을 자동으로 만드는 흐름을 짜는 개발자
어떻게 작동하나요
1. 쓸 폴더를 정해 연결해요. 설치 명령 끝의 --allow-dir 에 폴더를 적으면 AI는 그 폴더 안의 엑셀 파일만 열어요. 이미 있는 파일을 말없이 덮어쓰지도 않아요.2. AI는 먼저 파일을 살펴봐요. describe_workbook 으로 시트, 표, 차트가 어디 있는지 본 뒤 read_range 로 필요한 칸만 읽어요. 큰 시트는 쪽으로 나눠 받아요.3. 만들 땐 위치와 범위를 말해요. create_pivot_table 에 원본 범위(Data!A1:E200), 묶을 열(지역), 합칠 값(매출)을 넘기면 피벗이 생기고, 바뀐 위치와 이름을 돌려줘요. 다음 도구가 그 이름으로 차트를 붙여요.4. 위험한 수식은 막아요. 인터넷에 접속하거나 다른 프로그램을 부르는 함수(WEBSERVICE 등), 옛 매크로 함수, 다른 파일 참조는 쓰기 전에 거절해요. 매크로(VBA)는 읽기만 하고, 쓰기는 따로 켜야 하며 서버가 매크로를 실행하는 일은 없어요.핵심은 AI가 설명하는 대신, 정해진 도구로 파일을 직접 바꾸고 무엇을 바꿨는지 돌려준다는 거예요.
바로 쓸 수 있나요
필요한 것uv와 MCP를 지원하는 AI 도구(클로드 데스크톱, 클로드 코드, 커서, VS Code, 코덱스 등). 엑셀 프로그램은 필요 없어요
비용저장소는 무료(MIT). 함께 쓰는 AI 도구 요금은 따로예요
시작하기
- uv 설치
파이썬 프로그램을 설치 없이 바로 돌리는 도구예요. 모든 AI 도구가 uvx excel-mcp-server stdio 로 서버를 켜요.
- 클로드 데스크톱이라면
최신 릴리스에서 excel-mcp-server.mcpb 파일을 내려받아 열어요. 어느 폴더를 쓰게 할지 클로드가 물어요.
- 클로드 코드라면
/path/to/workbooks 자리에 엑셀 파일이 있는 폴더를 적어요.
claude mcp add excel --scope user -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks - 코덱스라면
커서와 VS Code는 설정 파일(mcp.json)에 넣는 방법이 README에 있고, excelmcpserver.com 에 한 번에 넣는 버튼이 있어요.
codex mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks - 앱이 uvx를 못 찾으면
맥의 데스크톱 앱은 터미널의 경로 설정을 못 볼 때가 많아요. 아래 명령이 알려 주는 전체 경로를 uvx 대신 적어요.
which uvx
매출.xlsx 의 Data 시트로 지역별, 분기별 매출 합계 피벗을 만들고 옆에 세로 막대 차트를 붙여 줘
README에 따로 예시 문장은 없어서, 도구 설명(피벗은 원본 범위, 묶을 열, 합칠 값)에 맞춰 저희가 만든 한마디예요. 처음엔 원본을 복사한 파일로 해 보세요.처음 쓰는 순서
describe_workbookAI가 파일 구조부터 파악read_range원본 데이터 범위 확인create_pivot_table지역, 분기로 묶은 피벗 만들기create_chart피벗 옆에 차트 붙이기trace_formula합계가 이상하면 수식 거슬러 확인
README와 TOOLS.md에 나온 도구를 월말 정리 순서로 묶은 예예요. 실제로 어떤 도구를 부를지는 AI가 정해요.
도구 하나에 시트가 이렇게 바뀌어요
README와 TOOLS.md에 나온 도구 이름과 매개변수를 이해하기 쉽게 저희가 지어낸 매출 표로 그린 예시예요. 돌려주는 값의 실제 모양과 숫자는 파일과 판 번호에 따라 달라요.
명령어 전체 16개, 언제 쓰나
살펴보기
describe_workbook- 파일 안 시트, 이름, 설정 한눈에 보기(첫 단계)
describe_sheet- 시트 위 표, 차트, 피벗, 메모 위치까지 보기
read_range- 칸 값 읽기. 큰 범위는 쪽으로 나눠 받기
만들기
create_pivot_table- 피벗 테이블 만들기
create_chart- 차트 넣기, 바꾸기
add_slicer- 피벗과 표에 슬라이서, 시간 막대 붙이기
add_sparklines- 셀 안에 작은 차트 넣기
set_table- 표 만들기, 합계 행과 계산 열
수식
trace_formula- 참조 따라가기, 수식 한 단계씩 풀기
goal_seek- 목표값 찾기
write_range- 값과 수식 쓰기
정리·서식
add_conditional_format- 색 단계, 데이터 막대, 아이콘 같은 조건부 서식
add_data_validation- 드롭다운, 입력 제한
sort_range- 여러 열 기준 정렬
transform_range- 중복 제거, 텍스트 나누기, 채우기
import_csv- CSV 파일을 시트로 가져오기
도구는 AI가 골라 불러요. 사람은 "지역별 분기 매출 피벗 만들어 줘"처럼 말로 시키면 돼요. 전체 46개(매크로 쓰기를 켜면 48개) 중 자주 쓸 만한 것만 골랐고, 모든 옵션은 TOOLS.md에 있어요. --tools data,charts 처럼 필요한 묶음만 켜면 AI가 매번 읽는 도구 설명이 줄어요.
비슷한 도구
excel-mcp-server는 엑셀 파일 하나를 깊게 다루고, 아래는 여러 문서 형식이나 재무 업무 흐름 쪽이에요(각 README 기준).
주의할 점
- AI가 만든 피벗과 수식은 계산을 도울 뿐이에요. 세금 신고, 비용 처리, 결산처럼 회계 판단이 들어가는 숫자는 최종 판단은 세무사에게 확인받으세요.
- --allow-dir 없이 켜면 컴퓨터 어디에 있는 엑셀 파일이든 절대 경로로 열 수 있어요. 쓸 폴더를 좁게 정해 두는 편이 안전해요. 바꾸면 안 되는 파일은 --read-only 로 읽기만 하게 할 수 있어요.
- 칸 안의 글은 데이터일 뿐인데, 남이 보낸 파일 안에 AI를 속이는 지시가 숨어 있을 수 있어요. 서버가 AI에게 따르지 말라고 알리지만, 출처를 모르는 파일은 AI가 무엇을 했는지 확인하라고 README가 적어요.
- 매크로 쓰기(--allow-vba-write)는 기본으로 꺼져 있어요. 켜면 AI가 쓴 매크로가 엑셀에서 내 권한으로 돌 수 있으니, 매크로를 켜기 전에 코드를 꼭 읽으라고 README가 경고해요.
- 옛 .xls 파일은 다루지 않아요. 계산 엔진이 못 푸는 수식은 빈 값으로 돌려주고, 최종 계산은 엑셀이 파일을 열 때 해요. 2.0에서 도구 이름이 바뀌어 1.x용 설정이나 저장해 둔 지시문은 고쳐야 해요.
더 보기
haris-musa가 만든 오픈소스예요. 계산 엔진은 실제 엑셀에서 기록한 수식 2,500개 넘게, 피벗은 엑셀에서 기록한 피벗 약 200개와 맞춰 보며 검사한다고 README가 밝혀요.
설치 안내 사이트 ↗도구 전체 설명(TOOLS.md) ↗바뀐 점(CHANGELOG) ↗보안 안내 ↗깃허브 저장소 ↗
낯선 말
- MCP · AI가 바깥 도구를 불러 쓰게 이어 주는 표준 연결 방식이에요
- 피벗 테이블 · 긴 표를 지역별, 월별처럼 원하는 기준으로 묶어 합계나 평균을 내는 엑셀 요약표예요
- 슬라이서 · 피벗이나 표 옆에 붙는 버튼 모음이에요. 눌러서 원하는 항목만 걸러 봐요
- 목표값 찾기 · 결과가 원하는 숫자가 되려면 입력을 얼마로 해야 하는지 거꾸로 찾는 엑셀 기능이에요
- uv · 파이썬 프로그램을 따로 설치하지 않고 바로 실행해 주는 도구예요
- openpyxl · 엑셀 파일을 엑셀 없이 읽고 쓰는 파이썬 라이브러리예요
댓글
AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.

