carrot-mcp-office

Carrot MCP Office Server — Excel and Word automation via MCP.

Features

Auto-backup: All modifications are automatically versioned to %APPDATA%/carrot-mcp/office/
Legacy format support: Automatically converts .doc → .docx and .xls → .xlsx via win32com (Windows)
Version history: Track and restore file versions

Tools

Tool	Description
`version`	Get server version info and backup configuration

Excel Tools

Tool	Description
`workbook_metadata`	Get workbook metadata (sheet names, properties)
`workbook_grep`	Search for exact substring in cell values across all sheets (or specific `sheet`). Case-insensitive by default, or regex.
`create_sheet`	Create a new sheet
`rename_sheet`	Rename a sheet
`delete_sheet`	Delete a sheet
`insert_rows`	Insert rows into a sheet
`delete_rows`	Delete rows from a sheet
`insert_columns`	Insert columns into a sheet
`delete_columns`	Delete columns from a sheet
`read_range`	Read cell values from a range as Markdown table (`format="markdown"`, default) or 2D array (`format="json"`)
`write_range`	Write a 2D array to a range (supports formulas)
`copy_range`	Copy a range to another location
`delete_range`	Clear cell contents in a range
`read_chart`	Read chart information from a sheet
`write_chart`	Create a chart (bar, line, pie, scatter)
`format_range`	Format cells (font, color, alignment, merge/unmerge)

All Excel tools accept .xls/.xlsx files (.xls auto-converted on Windows).

Word Tools

Tool	Description
`inspect`	Inspect document structure (paragraph count, table count and dimensions, image count, styles used).
`get_table`	Read table content as Markdown table (default) or 2D array (`format="json"`). Supports `row_range` slicing.
`insert_para`	Insert paragraph(s) with multi-line (`\n`) or string list support
`modify_para`	Modify paragraph text
`format_para`	Format a paragraph (style, alignment, font)
`delete_para`	Delete a paragraph
`insert_table`	Insert a table with optional data
`modify_table`	Modify a table cell
`format_table`	Apply a table style
`delete_table`	Delete a table
`insert_image`	Insert an image
`delete_image`	Delete an inline image
`get_outline`	Get document outline as tree + flat list via OpenXML `w:outlineLvl` and bilingual heading recognition. Use flat array indices with `get_content`.
`get_content`	Get paragraphs, tables, and images by `heading`, `section`, or `paragraph`. Returns clean Markdown (`format="markdown"`, default) or structured metadata for precision editing (`format="json"`).
`grep`	Search for exact substring or regex across paragraphs and table cells. Returns matches with heading path hierarchy, table header, and row data.

All Word tools accept .doc/.docx files (.doc auto-converted on Windows).

Backup Tools

Tool	Description
`backup_history`	List all backup versions of a file
`backup_restore`	Restore a file to a specific backup version

Backup System

Backups are stored in %APPDATA%/carrot-mcp/office/ with mirrored directory structure:

%APPDATA%/carrot-mcp/office/
├── _last_modified.txt
├── D/
│   └── docs/
│       └── reports/
│           ├── _versions.json
│           ├── file_v001.xlsx
│           ├── file_v002.xlsx
│           └── ...

Auto-versioning: Every modification creates a new version
100 version limit: Old versions are pruned when exceeded
14-day expiry: Versions older than 14 days are automatically deleted
Version numbers: Each mutation returns a version number in the result for LLM context

Configuration

Environment Variable	Default	Description
`CARROT_MCP_BACKUP_MAX_VERSIONS`	`100`	Max versions to keep per file
`CARROT_MCP_BACKUP_MAX_AGE_DAYS`	`14`	Days before auto-deletion
`CARROT_MCP_BACKUP_ROOT`	`%APPDATA%/carrot-mcp/office/`	Override backup root directory

Legacy Format Conversion

When you pass a .doc or .xls file path, the server automatically:

Detects the legacy format
If a .docx/.xlsx with the same name already exists in the same directory, reuses it directly (skips conversion)
Otherwise converts via win32com (preserves original file)
Operates on the .docx/.xlsx format

Requires pywin32 on Windows. Returns error on other platforms.

Usage

# Standalone
uv run carrot-mcp office

# Via main CLI
uv run carrot-mcp office

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

carrot_mcp_office-0.2.11.tar.gz (18.8 kB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

carrot_mcp_office-0.2.11-py3-none-any.whl (22.5 kB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file carrot_mcp_office-0.2.11.tar.gz.

File metadata

Download URL: carrot_mcp_office-0.2.11.tar.gz
Upload date: Aug 19, 2026
Size: 18.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for carrot_mcp_office-0.2.11.tar.gz
Algorithm	Hash digest
SHA256	`1b5142fc26c29f3aef452ea66d37b3da2c659efe4ef82b3460939b8b1d053cb1`
MD5	`cff2281f4c665a723ae882101589e1f2`
BLAKE2b-256	`7dbfca69f910b6763cca1654b8f34143be4a951712dba3d4857e92e312d51598`

See more details on using hashes here.

File details

Details for the file carrot_mcp_office-0.2.11-py3-none-any.whl.

File metadata

Download URL: carrot_mcp_office-0.2.11-py3-none-any.whl
Upload date: Aug 19, 2026
Size: 22.5 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for carrot_mcp_office-0.2.11-py3-none-any.whl
Algorithm	Hash digest
SHA256	`3ab89ef956b8251d9d9e2ac3ab249838c00f1b65bc8cebc927b912cd30c26e22`
MD5	`848c8a83ef754813cd36aed22d908b05`
BLAKE2b-256	`d985f790399aebe25af2fc037cc5f609542fe4bf3a74d8d40c974a480e1fa2a6`