OfficeCLI 설치 후 Word, Excel, PowerPoint 파일 다루기

개요

Word, Excel, PowerPoint 파일을 에이전트에게 맡기면 결과 파일을 열어보기 전까지는 서식이 맞는지 알기 어렵습니다. OfficeCLI는 .docx, .xlsx, .pptx를 CLI로 읽고 만들고 수정하는 도구입니다. 공식 README와 릴리스 정보를 확인했습니다. 직접 실행하지는 않았습니다.

OfficeCLI가 약속하는 범위는 세 문서 형식의 생성·읽기·수정과 HTML·PNG 렌더링입니다. Codex CLI나 Claude Code는 작업을 지시하는 에이전트이고, OfficeCLI는 문서 구조를 다루는 실행 도구입니다. 에이전트가 문서 요소를 바꾼 뒤 view 결과를 다시 읽는 흐름이 핵심입니다.

1. 왜 쓸 만한가

Office 문서 자동화는 python-docx, openpyxl, python-pptx처럼 형식별 라이브러리를 따로 익히는 경우가 많습니다. OfficeCLI는 한 CLI에서 세 포맷을 다루고, 각 명령의 --json 출력과 경로 기반 요소 선택을 제공합니다. 기존 템플릿을 반복 채우거나 에이전트가 만든 보고서를 확인해야 할 때 맞습니다.

• 문서 구조: /slide[1]/shape[1] 같은 경로로 대상을 지정합니다.
• 확인 루프: view html, view screenshot, watch로 결과를 점검합니다.
• 자동화 연결: MCP 등록 명령과 에이전트용 skill 설치 경로가 README에 있습니다.

저라면 이미 Python 문서 파이프라인이 안정적인 곳에는 새 도구를 넣지 않겠습니다. 반대로 Word, Excel, PowerPoint를 한 작업 흐름에서 함께 다루고, 생성 결과를 에이전트가 다시 확인해야 한다면 검토할 만합니다.

1. 준비 사항

릴리스 페이지에서 운영체제에 맞는 바이너리를 받거나 패키지 관리자를 사용합니다. macOS와 Linux는 설치 스크립트도 제공하지만, 자동 실행 전에는 스크립트 내용과 조직 정책을 먼저 확인해주시면 됩니다.

curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
officecli --version

Windows는 PowerShell 설치 경로가 따로 있습니다. 배포 파일 이름과 최신 버전은 OfficeCLI Releases에서 확인하시면 됩니다. 설치 후 officecli install을 실행하면 PATH 등록과 감지된 에이전트용 skill 설치를 시도합니다.

1. 문서 생성과 미리보기

PowerPoint를 만들고 제목 슬라이드를 추가하는 최소 예시는 아래와 같습니다.

officecli create deck.pptx
officecli add deck.pptx / --type slide --prop title="Q4 Report"
officecli view deck.pptx html
officecli close deck.pptx

officecli view deck.pptx html은 렌더링한 미리보기를 엽니다. 긴 작업은 officecli watch deck.pptx로 로컬 미리보기를 유지할 수 있습니다. README 기준 주소는 http://localhost:26315입니다. 에이전트가 수정한 뒤 파일 외부 프로그램이 읽어야 하면 officecli save <파일> 또는 officecli close <파일>로 디스크에 반영해야 합니다.

1. 에이전트 연결

MCP를 쓰면 문서 조작 명령을 JSON-RPC 도구로 등록할 수 있습니다. 대상 도구의 설정을 자동으로 바꾸는 명령이므로 기존 MCP 설정을 백업한 뒤 실행해주시면 됩니다.

officecli mcp claude
officecli mcp cursor
officecli mcp vscode
officecli mcp list

Claude Code, Cursor, VS Code와의 등록 명령은 README에 명시되어 있습니다. Codex CLI는 officecli install이 알려진 설정 경로를 감지해 skill 파일을 설치한다고 설명합니다. 자동 감지에 의존하기보다 officecli mcp list와 에이전트 설정 파일을 함께 확인하는 편이 안전합니다.

1. 적용 대상

정기 보고서, 제안서, 스프레드시트 템플릿처럼 문서 파일을 반복 생성하는 작업에 맞습니다. Office 앱 설치 없이 서버나 CI 환경에서 문서를 다뤄야 하는 경우도 대상입니다. 단발성 문서 편집이나 이미 검증된 Office 매크로·Python 파이프라인만 쓰는 팀에는 추가 학습 비용이 생깁니다.

Word 문서와 컨테이너 작업을 함께 관리한다면 Docker Compose로 n8n 설치하기처럼 기존 자동화 환경을 먼저 정리해두는 편이 좋습니다.

확인

설치 상태와 사용 가능한 명령은 아래 순서로 확인합니다.

officecli --version
officecli --help
officecli mcp list

버전과 도움말이 출력되고 등록한 MCP 대상이 목록에 나타나면 기본 준비가 끝난 상태입니다.