Compare two spreadsheets
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the user has two versions of the same spreadsheet (CSV or Excel: price list, inventory, roster, budget, product catalog, CRM export) and wants to "compare two excel files", "compare two spreadsheets", "find the differences between two csv files", "what changed between these files" or "list what changed". Matches rows by a key column it detects (or key_columns), lists all added, removed and changed rows with each changed cell old -> new, numeric change and percent, plus renamed/moved columns and key changes, and returns an Excel workbook (Summary, Changed, Cell changes, Added, Removed, annotated new version) and a changes CSV. Does not merge or join two different tables (e.g. customers + orders), does not compare Word or PDF documents, and does not edit either file.
The NEWER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q4.xlsx or roster-october.csv.
The OLDER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q3.xlsx or roster-september.csv.
Sheet (tab) to read from the new workbook, e.g. Prices Q4.
Instead of new_file: the newer version pasted as CSV/TSV text with a header row, e.g. "SKU,Price\nA1,10.50\nC3,7.00".
Sheet (tab) to read from the old workbook, e.g. Prices Q3. Default: the sheet with the same name as in the new workbook, else the first sheet with data.
Instead of old_file: the older version pasted as CSV/TSV text with a header row, e.g. "SKU,Price\nA1,10.00\nB2,5.00".
Old column name -> new column name for renamed columns, e.g. {"Unit Price": "Price (USD)"}. Turns off automatic rename detection.
Treat ABC and abc as equal, e.g. true. Default false.
Column(s) that identify a row, to override the automatic key, e.g. ["SKU"] or ["Store", "Product code"].
Row number of the column headings in the new file, e.g. 3.
Row number of the column headings in the old file when it is not detected, e.g. 3 when two title rows come first.
Columns to leave out of the comparison, e.g. ["Last updated", "Notes"].
Compare dates by calendar day, so 2026-03-05, 3/5/2026 and an Excel date serial are equal, e.g. true (default).
Ignore leading/trailing and repeated spaces, e.g. true (default).
Numbers that differ by this much or less count as equal, e.g. 0.01 to ignore rounding by a cent. Default 0.
Report a removed row and an added row whose other values are identical as one key change (e.g. a SKU renumbered), e.g. true (default).
Compare a running row-number column (#, Row, No.: 1, 2, 3...) like any other column, e.g. true. Default false: it shifts whenever a row is inserted, so it is skipped with a note.
Compare numbers by value so "1,200.00" equals 1200, e.g. true (default). Codes with leading zeros (00123) stay text.
Use this when the user has two versions of the same spreadsheet (CSV or Excel: price list, inventory, roster, budget, product catalog, CRM export) and wants to "compare two excel files", "compare two spreadsheets", "find the differences between two csv files", "what changed between these files" or "list what changed". Matches rows by a key column it detects (or key_columns), lists all added, removed and changed rows with each changed cell old -> new, numeric change and percent, plus renamed/moved columns and key changes, and returns an Excel workbook (Summary, Changed, Cell changes, Added, Removed, annotated new version) and a changes CSV. Does not merge or join two different tables (e.g. customers + orders), does not compare Word or PDF documents, and does not edit either file.
| Argument | Type | Description |
|---|---|---|
| new_file | object | The NEWER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q4.xlsx or roster-october.csv. |
| old_file | object | The OLDER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q3.xlsx or roster-september.csv. |
| new_sheet | string | Sheet (tab) to read from the new workbook, e.g. Prices Q4. |
| new_table | string | Instead of new_file: the newer version pasted as CSV/TSV text with a header row, e.g. "SKU,Price\nA1,10.50\nC3,7.00". |
| old_sheet | string | Sheet (tab) to read from the old workbook, e.g. Prices Q3. Default: the sheet with the same name as in the new workbook, else the first sheet with data. |
| old_table | string | Instead of old_file: the older version pasted as CSV/TSV text with a header row, e.g. "SKU,Price\nA1,10.00\nB2,5.00". |
| column_map | object | Old column name -> new column name for renamed columns, e.g. {"Unit Price": "Price (USD)"}. Turns off automatic rename detection. |
| ignore_case | boolean | Treat ABC and abc as equal, e.g. true. Default false. |
| key_columns | array | Column(s) that identify a row, to override the automatic key, e.g. ["SKU"] or ["Store", "Product code"]. |
| header_row_new | integer | Row number of the column headings in the new file, e.g. 3. |
| header_row_old | integer | Row number of the column headings in the old file when it is not detected, e.g. 3 when two title rows come first. |
| ignore_columns | array | Columns to leave out of the comparison, e.g. ["Last updated", "Notes"]. |
| normalize_dates | boolean | Compare dates by calendar day, so 2026-03-05, 3/5/2026 and an Excel date serial are equal, e.g. true (default). |
| trim_whitespace | boolean | Ignore leading/trailing and repeated spaces, e.g. true (default). |
| numeric_tolerance | number | Numbers that differ by this much or less count as equal, e.g. 0.01 to ignore rounding by a cent. Default 0. |
| detect_key_changes | boolean | Report a removed row and an added row whose other values are identical as one key change (e.g. a SKU renumbered), e.g. true (default). |
| compare_row_numbers | boolean | Compare a running row-number column (#, Row, No.: 1, 2, 3...) like any other column, e.g. true. Default false: it shifts whenever a row is inserted, so it is skipped with a note. |
| compare_numbers_as_values | boolean | Compare numbers by value so "1,200.00" equals 1200, e.g. true (default). Codes with leading zeros (00123) stay text. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"new_file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"file_name": {
"type": "string",
"description": "Original file name if known, e.g. statement.pdf."
},
"mime_type": {
"type": "string",
"description": "Media type if known, e.g. application/pdf."
},
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
}
},
"description": "The NEWER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q4.xlsx or roster-october.csv."
},
"old_file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"file_name": {
"type": "string",
"description": "Original file name if known, e.g. statement.pdf."
},
"mime_type": {
"type": "string",
"description": "Media type if known, e.g. application/pdf."
},
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
}
},
"description": "The OLDER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q3.xlsx or roster-september.csv."
},
"new_sheet": {
"type": "string",
"maxLength": 100,
"description": "Sheet (tab) to read from the new workbook, e.g. Prices Q4."
},
"new_table": {
"type": "string",
"maxLength": 200000,
"description": "Instead of new_file: the newer version pasted as CSV/TSV text with a header row, e.g. \"SKU,Price\\nA1,10.50\\nC3,7.00\"."
},
"old_sheet": {
"type": "string",
"maxLength": 100,
"description": "Sheet (tab) to read from the old workbook, e.g. Prices Q3. Default: the sheet with the same name as in the new workbook, else the first sheet with data."
},
"old_table": {
"type": "string",
"maxLength": 200000,
"description": "Instead of old_file: the older version pasted as CSV/TSV text with a header row, e.g. \"SKU,Price\\nA1,10.00\\nB2,5.00\"."
},
"column_map": {
"type": "object",
"description": "Old column name -> new column name for renamed columns, e.g. {\"Unit Price\": \"Price (USD)\"}. Turns off automatic rename detection.",
"propertyNames": {
"type": "string",
"maxLength": 100
},
"additionalProperties": {
"type": "string",
"maxLength": 100
}
},
"ignore_case": {
"type": "boolean",
"description": "Treat ABC and abc as equal, e.g. true. Default false."
},
"key_columns": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 5,
"description": "Column(s) that identify a row, to override the automatic key, e.g. [\"SKU\"] or [\"Store\", \"Product code\"]."
},
"header_row_new": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Row number of the column headings in the new file, e.g. 3."
},
"header_row_old": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Row number of the column headings in the old file when it is not detected, e.g. 3 when two title rows come first."
},
"ignore_columns": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50,
"description": "Columns to leave out of the comparison, e.g. [\"Last updated\", \"Notes\"]."
},
"normalize_dates": {
"type": "boolean",
"description": "Compare dates by calendar day, so 2026-03-05, 3/5/2026 and an Excel date serial are equal, e.g. true (default)."
},
"trim_whitespace": {
"type": "boolean",
"description": "Ignore leading/trailing and repeated spaces, e.g. true (default)."
},
"numeric_tolerance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Numbers that differ by this much or less count as equal, e.g. 0.01 to ignore rounding by a cent. Default 0."
},
"detect_key_changes": {
"type": "boolean",
"description": "Report a removed row and an added row whose other values are identical as one key change (e.g. a SKU renumbered), e.g. true (default)."
},
"compare_row_numbers": {
"type": "boolean",
"description": "Compare a running row-number column (#, Row, No.: 1, 2, 3...) like any other column, e.g. true. Default false: it shifts whenever a row is inserted, so it is skipped with a note."
},
"compare_numbers_as_values": {
"type": "boolean",
"description": "Compare numbers by value so \"1,200.00\" equals 1200, e.g. true (default). Codes with leading zeros (00123) stay text."
}
}
}Use this when the user has two versions of a spreadsheet and wants a summary rather than a full list: "how many prices went up", "which columns changed the most", "biggest changes between these two files", "average price increase". Returns counts (changed, added, removed rows), per-column statistics (cells changed, increases, decreases, total and average percent change, largest increase and decrease) and the biggest single changes, with the same Excel and CSV downloads. Use compare_spreadsheets for the row-by-row list. Does not forecast or explain why values changed.
| Argument | Type | Description |
|---|---|---|
| new_file | object | The NEWER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q4.xlsx or roster-october.csv. |
| old_file | object | The OLDER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q3.xlsx or roster-september.csv. |
| new_sheet | string | Sheet (tab) to read from the new workbook, e.g. Prices Q4. |
| new_table | string | Instead of new_file: the newer version pasted as CSV/TSV text with a header row, e.g. "SKU,Price\nA1,10.50\nC3,7.00". |
| old_sheet | string | Sheet (tab) to read from the old workbook, e.g. Prices Q3. Default: the sheet with the same name as in the new workbook, else the first sheet with data. |
| old_table | string | Instead of old_file: the older version pasted as CSV/TSV text with a header row, e.g. "SKU,Price\nA1,10.00\nB2,5.00". |
| column_map | object | Old column name -> new column name for renamed columns, e.g. {"Unit Price": "Price (USD)"}. Turns off automatic rename detection. |
| ignore_case | boolean | Treat ABC and abc as equal, e.g. true. Default false. |
| key_columns | array | Column(s) that identify a row, to override the automatic key, e.g. ["SKU"] or ["Store", "Product code"]. |
| header_row_new | integer | Row number of the column headings in the new file, e.g. 3. |
| header_row_old | integer | Row number of the column headings in the old file when it is not detected, e.g. 3 when two title rows come first. |
| ignore_columns | array | Columns to leave out of the comparison, e.g. ["Last updated", "Notes"]. |
| normalize_dates | boolean | Compare dates by calendar day, so 2026-03-05, 3/5/2026 and an Excel date serial are equal, e.g. true (default). |
| trim_whitespace | boolean | Ignore leading/trailing and repeated spaces, e.g. true (default). |
| numeric_tolerance | number | Numbers that differ by this much or less count as equal, e.g. 0.01 to ignore rounding by a cent. Default 0. |
| detect_key_changes | boolean | Report a removed row and an added row whose other values are identical as one key change (e.g. a SKU renumbered), e.g. true (default). |
| compare_row_numbers | boolean | Compare a running row-number column (#, Row, No.: 1, 2, 3...) like any other column, e.g. true. Default false: it shifts whenever a row is inserted, so it is skipped with a note. |
| compare_numbers_as_values | boolean | Compare numbers by value so "1,200.00" equals 1200, e.g. true (default). Codes with leading zeros (00123) stay text. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"new_file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"file_name": {
"type": "string",
"description": "Original file name if known, e.g. statement.pdf."
},
"mime_type": {
"type": "string",
"description": "Media type if known, e.g. application/pdf."
},
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
}
},
"description": "The NEWER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q4.xlsx or roster-october.csv."
},
"old_file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"file_name": {
"type": "string",
"description": "Original file name if known, e.g. statement.pdf."
},
"mime_type": {
"type": "string",
"description": "Media type if known, e.g. application/pdf."
},
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
}
},
"description": "The OLDER version (CSV, TSV or Excel .xlsx), e.g. pricelist_2026Q3.xlsx or roster-september.csv."
},
"new_sheet": {
"type": "string",
"maxLength": 100,
"description": "Sheet (tab) to read from the new workbook, e.g. Prices Q4."
},
"new_table": {
"type": "string",
"maxLength": 200000,
"description": "Instead of new_file: the newer version pasted as CSV/TSV text with a header row, e.g. \"SKU,Price\\nA1,10.50\\nC3,7.00\"."
},
"old_sheet": {
"type": "string",
"maxLength": 100,
"description": "Sheet (tab) to read from the old workbook, e.g. Prices Q3. Default: the sheet with the same name as in the new workbook, else the first sheet with data."
},
"old_table": {
"type": "string",
"maxLength": 200000,
"description": "Instead of old_file: the older version pasted as CSV/TSV text with a header row, e.g. \"SKU,Price\\nA1,10.00\\nB2,5.00\"."
},
"column_map": {
"type": "object",
"description": "Old column name -> new column name for renamed columns, e.g. {\"Unit Price\": \"Price (USD)\"}. Turns off automatic rename detection.",
"propertyNames": {
"type": "string",
"maxLength": 100
},
"additionalProperties": {
"type": "string",
"maxLength": 100
}
},
"ignore_case": {
"type": "boolean",
"description": "Treat ABC and abc as equal, e.g. true. Default false."
},
"key_columns": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 5,
"description": "Column(s) that identify a row, to override the automatic key, e.g. [\"SKU\"] or [\"Store\", \"Product code\"]."
},
"header_row_new": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Row number of the column headings in the new file, e.g. 3."
},
"header_row_old": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Row number of the column headings in the old file when it is not detected, e.g. 3 when two title rows come first."
},
"ignore_columns": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50,
"description": "Columns to leave out of the comparison, e.g. [\"Last updated\", \"Notes\"]."
},
"normalize_dates": {
"type": "boolean",
"description": "Compare dates by calendar day, so 2026-03-05, 3/5/2026 and an Excel date serial are equal, e.g. true (default)."
},
"trim_whitespace": {
"type": "boolean",
"description": "Ignore leading/trailing and repeated spaces, e.g. true (default)."
},
"numeric_tolerance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Numbers that differ by this much or less count as equal, e.g. 0.01 to ignore rounding by a cent. Default 0."
},
"detect_key_changes": {
"type": "boolean",
"description": "Report a removed row and an added row whose other values are identical as one key change (e.g. a SKU renumbered), e.g. true (default)."
},
"compare_row_numbers": {
"type": "boolean",
"description": "Compare a running row-number column (#, Row, No.: 1, 2, 3...) like any other column, e.g. true. Default false: it shifts whenever a row is inserted, so it is skipped with a note."
},
"compare_numbers_as_values": {
"type": "boolean",
"description": "Compare numbers by value so \"1,200.00\" equals 1200, e.g. true (default). Codes with leading zeros (00123) stay text."
}
}
}