Our take
- Activity
- 90
- Community
- 30
- Issues
- 70
- Pull requests
- 49
+1,242 stars in the last 30 days
- Releases more often than 93% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
33,360Forks
2,277Change since Nov 16, 2026: +25 stars·-2 forks
Overview
OfficeCLI provides one command-line interface for working with Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) files. It addresses the gap between document libraries and office applications by exposing file contents as structured, addressable elements that scripts and AI agents can inspect and modify.
It is a fit for workflows that need headless document automation, agent-friendly JSON operations, or a visual feedback loop without installing Microsoft Office. Its built-in rendering and preview commands let users inspect generated output, while lower-level XML operations offer a fallback for specialized edits.
Key Features
- Create, read, modify, and validate Word, Excel, and PowerPoint files from a single CLI.
- Address document elements by paths and query them with structured operations such as
get,set,add,remove, andmove. - Return JSON output for programmatic workflows and AI agents, with structured errors and suggestions.
- Render documents as HTML or screenshots, or use
watchfor a browser preview that refreshes after edits. - Evaluate Excel formulas and create native pivot tables without round-tripping through Office.
- Support batch operations, in-memory resident sessions, and template merging with JSON data.
- Integrate with AI tools through a built-in MCP server and agent skill installation.
Use Cases
- AI-agent developers can generate or update office files from prompts, then inspect rendered output to catch layout problems.
- Developers can automate recurring reports from application data, APIs, or test results in scripts and CI pipelines.
- Teams can populate existing document templates repeatedly with consistent data and formatting.
- Analysts can extract structured content from office files or make bulk spreadsheet changes without opening a desktop office suite.
Getting Started
Install on macOS or Linux with:
curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
For Windows, package managers, and usage details, see the README. The project also provides an official website.
Considerations
- The repository describes the tool as a self-contained binary with no Office installation required at runtime. Building from source requires the .NET 10 SDK.
- Its scope is office document formats, not a general-purpose replacement for desktop office applications. Rendering and editing should be checked against the needs of the target files and workflow.
- The feature set is broad, so users may need the wiki for format-specific commands and behavior.
- The repository metadata lists 105 open issues. Review current issues and releases before relying on it for a critical production workflow.
Found this useful?
Share it with someone who would like OfficeCLI.