Zovo Spreadsheet Merge
Merge two spreadsheets on an ID column, the VLOOKUP job, and see how each row matched.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~3,551トークン数（ツール定義）
~18.3 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 2.77%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"sheet-join": {
"url": "https://sheet-join.zovo.one/mcp"
}
}
}リモートエンドポイント
https://sheet-join.zovo.one/mcpstreamable-httpできること
ツール一覧
ツール（2）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢join_spreadsheets(left_file, right_file, left_table, right_table, left_sheet, ...)
Use this when the user wants to merge, match or VLOOKUP two spreadsheets on a shared ID column: "vlookup two spreadsheets", "merge two excel files by customer ID", "match orders to customers", "why are some rows not matching", "find which IDs are missing from the other file". Attach both files (CSV, TSV or .xlsx; or one workbook with two sheets) or paste both tables. Left join by default (all left rows kept); inner and full joins are available. Auto-detects the key column and explains why (override with left_key/right_key, or give a composite key). Key clean-ups are applied in order and each is counted: spaces, case, look-alike characters, Excel number formats (12345.0, 1.2345E+05), separators, leading zeros (C00123 = C123), letter prefix used by one file only; turn any off with skip_normalizations. Reports unmatched rows on both sides with a likely reason and closest key, duplicate keys with fan-out counts, and returns an Excel workbook (Merged, Unmatched left, Unmatched right, Duplicates, Summary) plus a merged CSV. Does not do mail merge (letters, labels, emails), does not compare two versions of one file cell by cell, and does not edit the original files.
入力スキーマ
{
"type": "object",
"properties": {
"left_file": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
},
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"mime_type": {
"description": "Media type if known, e.g. application/pdf.",
"type": "string"
},
"file_name": {
"description": "Original file name if known, e.g. statement.pdf.",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"description": "The main file whose rows you keep (CSV, TSV or .xlsx), e.g. orders.csv. A workbook with two sheets can be passed alone: sheet 1 is joined to sheet 2."
},
"right_file": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
},
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"mime_type": {
"description": "Media type if known, e.g. application/pdf.",
"type": "string"
},
"file_name": {
"description": "Original file name if known, e.g. statement.pdf.",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"description": "The lookup file whose columns are added (CSV, TSV or .xlsx), e.g. customers.xlsx."
},
"left_table": {
"description": "Only when no file is attached: the left (main) table pasted as CSV or tab-separated text with a header row, e.g. \"order_id,customer_id,amount\\nSO-1,C123,40.00\".",
"type": "string",
"maxLength": 400000
},
"right_table": {
"description": "Only when no file is attached: the right (lookup) table pasted as CSV or tab-separated text with a header row, e.g. \"customer_id,name\\nC00123,Acme Supply\".",
"type": "string",
"maxLength": 400000
},
"left_sheet": {
"description": "Sheet name in the left workbook, e.g. Orders. Default: the first sheet with data.",
"type": "string",
"maxLength": 100
},
"right_sheet": {
"description": "Sheet name in the right workbook, e.g. Customers. Default: the first sheet with data (or the second sheet when both tables are in one workbook).",
"type": "string",
"maxLength": 100
},
"left_key": {
"description": "Key column name(s) in the left file; leave out to auto-detect. Use a list for a composite key, e.g. \"customer_id\" or [\"First Name\",\"Last Name\"].",
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"maxLength": 120
}
}
]
},
"right_key": {
"description": "Key column name(s) in the right file; leave out to auto-detect. Use a list for a composite key, e.g. \"Customer ID\" or [\"First Name\",\"Last Name\"].",
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"maxLength": 120
}
}
]
},
"join_type": {
"description": "left (default, like VLOOKUP): keep every left row and add matching right columns. inner: only rows found in both. full: everything from both files, matched where possible. Example: left.",
"type": "string",
"enum": [
"left",
"inner",
"full"
]
},
"skip_normalizations": {
"description": "Key clean-ups to turn OFF when IDs that differ only that way are really different, e.g. [\"case\"] for case-sensitive IDs or [\"zeros\"] when 0123 and 123 are different codes. Options: trim, case, unicode, excel, separators, zeros, prefix.",
"maxItems": 7,
"type": "array",
"items": {
"type": "string",
"enum": [
"trim",
"case",
"unicode",
"excel",
"separators",
"zeros",
"prefix"
]
}
},
"left_header_row": {
"description": "Only if the headings were detected wrongly: the row number of the left file's header (counting non-blank rows in a CSV, sheet rows in Excel), e.g. 4.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"right_header_row": {
"description": "Only if the headings were detected wrongly: the row number of the right file's header, e.g. 3.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"duplicates": {
"description": "When a key appears more than once in the right file: all (default) keeps every match and warns about the extra rows; first keeps only the first match, like VLOOKUP. Example: first.",
"type": "string",
"enum": [
"all",
"first"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"left": {
"type": "object",
"properties": {
"file": {
"type": "string"
},
"rows": {
"type": "number"
},
"key": {
"type": "array",
"items": {
"type": "string"
}
},
"excluded_rows": {
"type": "number"
}
},
"required": [
"file",
"rows",
"key",
"excluded_rows"
],
"additionalProperties": false
},
"right": {
"type": "object",
"properties": {
"file": {
"type": "string"
},
"rows": {
"type": "number"
},
"key": {
"type": "array",
"items": {
"type": "string"
}
},
"excluded_rows": {
"type": "number"
}
},
"required": [
"file",
"rows",
"key",
"excluded_rows"
],
"additionalProperties": false
},
"key_choice": {
"type": "object",
"properties": {
"how": {
"type": "string"
},
"explanation": {
"type": "string"
},
"alternatives": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"how",
"explanation",
"alternatives"
],
"additionalProperties": false
},
"join_type": {
"type": "string"
},
"match": {
"type": "object",
"properties": {
"left_matched": {
"type": "number"
},
"left_unmatched": {
"type": "number"
},
"match_rate_pct": {
"type": "number"
},
"right_used": {
"type": "number"
},
"right_unused": {
"type": "number"
},
"merged_rows": {
"type": "number"
},
"ambiguous": {
"type": "number"
},
"blank_keys": {
"type": "number"
}
},
"required": [
"left_matched",
"left_unmatched",
"match_rate_pct",
"right_used",
"right_unused",
"merged_rows",
"ambiguous",
"blank_keys"
],
"additionalProperties": false
},
"normalizations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"step": {
"type": "string"
},
"label": {
"type": "string"
},
"rows": {
"type": "number"
},
"examples": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"step",
"label",
"rows",
"examples"
],
"additionalProperties": false
}
},
"turned_off": {
"type": "array",
"items": {
"type": "string"
}
},
"would_match_if_on": {
"type": "array",
"items": {
"type": "object",
"properties": {
"step": {
"type": "string"
},
"rows": {
"type": "number"
}
},
"required": [
"step",
"rows"
],
"additionalProperties": false
}
},
"prefix_rule": {
"type": [
"string",
"null"
]
},
"unmatched_reasons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"reason": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"reason",
"count"
],
"additionalProperties": false
}
},
"unmatched_preview": {
"type": "array",
"items": {
"type": "object",
"properties": {
"row": {
"type": "number"
},
"key": {
"type": "string"
},
"reason": {
"type": "string"
},
"suggestion": {
"type": [
"string",
"null"
]
}
},
"required": [
"row",
"key",
"reason",
"suggestion"
],
"additionalProperties": false
}
},
"duplicates": {
"type": "object",
"properties": {
"right_keys": {
"type": "number"
},
"left_rows_fanned_out": {
"type": "number"
},
"extra_rows": {
"type": "number"
},
"many_to_many_keys": {
"type": "number"
},
"capped": {
"type": "boolean"
},
"top": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"rows": {
"type": "number"
},
"extra_rows": {
"type": "number"
}
},
"required": [
"key",
"rows",
"extra_rows"
],
"additionalProperties": false
}
}
},
"required": [
"right_keys",
"left_rows_fanned_out",
"extra_rows",
"many_to_many_keys",
"capped",
"top"
],
"additionalProperties": false
},
"excluded": {
"type": "array",
"items": {
"type": "string"
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"downloads": {
"type": "object",
"properties": {
"xlsx": {
"type": "string"
},
"csv": {
"type": "string"
}
},
"required": [
"xlsx",
"csv"
],
"additionalProperties": false
},
"note": {
"type": "string"
}
},
"required": [
"left",
"right",
"key_choice",
"join_type",
"match",
"normalizations",
"turned_off",
"would_match_if_on",
"prefix_rule",
"unmatched_reasons",
"unmatched_preview",
"duplicates",
"excluded",
"warnings",
"downloads",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢combine_spreadsheets(files, tables, column_map, date_order, unify_case, ...)
Use this when the user wants to stack or append many spreadsheets into one: "combine multiple csv files into one", "merge 12 monthly excel files", "combine excel files with different column names", "append these exports into one sheet", "combine all sheets into one". Takes 1 to 24 CSV, TSV or .xlsx files (or pasted tables). Aligns columns by identical name, then same name with different case or spacing, then a synonym table (Amt = Amount, Txn Date = Date, Memo = Description), then fuzzy spelling matches that are listed for confirmation; a specific column is not folded into a more general one (Spouse First Name stays separate from First Name). Adds a Source file column, decides day/month order once per file, reads EU number formats, removes total rows and repeated headers (listed), and reports each column decision. Returns an Excel workbook (Combined, Column mapping, Files, Excluded rows, Summary) and a CSV. Does not join files side by side on an ID (use join_spreadsheets) and does not do mail merge.
入力スキーマ
{
"type": "object",
"properties": {
"files": {
"minItems": 1,
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
},
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"mime_type": {
"description": "Media type if known, e.g. application/pdf.",
"type": "string"
},
"file_name": {
"description": "Original file name if known, e.g. statement.pdf.",
"type": "string"
}
},
"required": [
"download_url",
"file_id"
]
},
"description": "The spreadsheets to stack, 1 to 24 CSV, TSV or .xlsx files in order, e.g. jan.csv, feb.csv, mar.csv. One workbook alone stacks all of its sheets."
},
"tables": {
"description": "Only when no files are attached: pasted tables to stack, e.g. [{\"name\":\"Jan\",\"csv\":\"Date,Amt\\n1/5/2025,12.50\"}].",
"minItems": 1,
"maxItems": 24,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 80,
"description": "A label for this table, e.g. January."
},
"csv": {
"type": "string",
"maxLength": 200000,
"description": "The table as CSV or tab-separated text with a header row, e.g. \"Date,Amount\\n01/05/2025,12.50\"."
}
},
"required": [
"name",
"csv"
]
}
},
"column_map": {
"description": "Your column decisions: source header -> output column, e.g. {\"Amt\":\"Amount\",\"Txn Date\":\"Date\"}. Overrides automatic matching.",
"type": "object",
"propertyNames": {
"type": "string",
"maxLength": 80
},
"additionalProperties": {
"type": "string",
"maxLength": 80
}
},
"date_order": {
"description": "Day/month order for numeric dates: auto (default) decides once per file from the data and says when it had to assume US month/day; MDY or DMY forces it for all files. Example: DMY.",
"type": "string",
"enum": [
"auto",
"MDY",
"DMY"
]
},
"unify_case": {
"description": "Default true: in short category-style columns, spellings that differ only by case (Revenue vs revenue) become the spelling seen first (first file wins); each change is listed. false keeps values as typed.",
"type": "boolean"
},
"remove_duplicate_rows": {
"description": "Default false: rows identical in every column are counted and reported but kept. true drops the repeats (e.g. overlapping monthly exports).",
"type": "boolean"
},
"header_row": {
"description": "Only if the headings were detected wrongly: the header row number used for EVERY file (counting non-blank rows in a CSV, sheet rows in Excel), e.g. 4.",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"all_sheets": {
"description": "Stack every sheet of each workbook instead of only the first sheet with data. Default: true when a single workbook is given, otherwise false.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}出力スキーマ
{
"type": "object",
"properties": {
"tables": {
"type": "number"
},
"rows": {
"type": "number"
},
"columns": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"files": {
"type": "number"
}
},
"required": [
"name",
"type",
"files"
],
"additionalProperties": false
}
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"file": {
"type": "string"
},
"rows": {
"type": "number"
},
"excluded": {
"type": "number"
},
"date_order": {
"type": [
"string",
"null"
]
},
"new_columns": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"file",
"rows",
"excluded",
"date_order",
"new_columns"
],
"additionalProperties": false
}
},
"mapping_changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"file": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"how": {
"type": "string"
}
},
"required": [
"file",
"from",
"to",
"how"
],
"additionalProperties": false
}
},
"mapping_changes_total": {
"type": "number"
},
"needs_confirmation": {
"type": "array",
"items": {
"type": "object",
"properties": {
"file": {
"type": "string"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"file",
"from",
"to"
],
"additionalProperties": false
}
},
"not_merged": {
"type": "array",
"items": {
"type": "string"
}
},
"value_fixes": {
"type": "array",
"items": {
"type": "string"
}
},
"excluded": {
"type": "object",
"properties": {
"rows": {
"type": "number"
},
"examples": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"rows",
"examples"
],
"additionalProperties": false
},
"duplicates": {
"type": "object",
"properties": {
"rows": {
"type": "number"
},
"across_files": {
"type": "number"
},
"removed": {
"type": "number"
}
},
"required": [
"rows",
"across_files",
"removed"
],
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"preview": {
"type": "object",
"properties": {
"header": {
"type": "array",
"items": {
"type": "string"
}
},
"rows": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"required": [
"header",
"rows"
],
"additionalProperties": false
},
"downloads": {
"type": "object",
"properties": {
"xlsx": {
"type": "string"
},
"csv": {
"type": "string"
}
},
"required": [
"xlsx",
"csv"
],
"additionalProperties": false
},
"note": {
"type": "string"
}
},
"required": [
"tables",
"rows",
"columns",
"files",
"mapping_changes",
"mapping_changes_total",
"needs_confirmation",
"not_merged",
"value_fixes",
"excluded",
"duplicates",
"warnings",
"preview",
"downloads",
"note"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 2 件