docs(excel): Clarify parameter behavior in search mode

k-ibaraki · claude · k-ibaraki · commit 5dc73efb2277 · 2026-02-05T16:30:34.000+09:00
- Add note to tool description that metadata_only and include_header
  are ignored in search mode (when query parameter is used)
- Improves AI understanding of correct tool usage

Co-Authored-By: Claude Sonnet 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/src/server.py b/src/server.py
@@ -549,6 +549,7 @@ def register_tools():
                 "even when they're outside the specified cell_range - headers will be in 'header_rows', data in 'data_rows'. "
                 "Use 'metadata_only=True' to get only file structure and headers without data rows (useful for understanding file layout). "
                 "Use 'include_formatting=True' to include cell formatting details. "
+                "Note: 'metadata_only' and 'include_header' are ignored in search mode (when using 'query'). "
                 "Workflow: 1) Search with query to find relevant cells, "
                 "2) Read specific cell_range based on search results."
             )

Original file line number	Diff line number	Diff line change
`@@ -549,6 +549,7 @@ def register_tools():`
`549`	`549`	`"even when they're outside the specified cell_range - headers will be in 'header_rows', data in 'data_rows'. "`
`550`	`550`	`"Use 'metadata_only=True' to get only file structure and headers without data rows (useful for understanding file layout). "`
`551`	`551`	`"Use 'include_formatting=True' to include cell formatting details. "`
	`552`	`+ "Note: 'metadata_only' and 'include_header' are ignored in search mode (when using 'query'). "`
`552`	`553`	`"Workflow: 1) Search with query to find relevant cells, "`
`553`	`554`	`"2) Read specific cell_range based on search results."`
`554`	`555`	`)`