mcp-gee-sweet 0.7.0.dev70__tar.gz → 0.7.0.dev72__tar.gz

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/CLAUDE.md

@@ -34,7 +34,7 @@ Logic is split across `src/mcp_gee_sweet/`: `server.py` (MCP setup, tool decorat
 - `tools/sheets/data.py` — read/write cell data (`get_sheet_data`, `get_sheet_formulas`, `get_multiple_*`, `find_in_spreadsheet`, `clear_values`, `update_cells`, `batch_update_cells`, `batch_update`)
 - `tools/sheets/structure.py` — sheet structure (`list_sheets`, `copy_sheet`, `rename_sheet`, `create_sheet`, `delete_sheet`, `add_rows`, `add_columns`, `delete_rows`, `delete_columns`, `format_cells`, `merge_cells`, `unmerge_cells`, `freeze`, `sort_range`, `add_chart`)
 - `tools/sheets/helpers.py` — A1 notation helpers (`_parse_a1_notation`, `_column_index_to_letter`, etc.)
-- `tools/drive/files.py` — file/folder operations (`create_spreadsheet`, `list_spreadsheets`, `list_files`, `search_files`, `create_folder`, `copy_file`, `move_file`, `rename_file`, `delete_file`, `list_shared_with_me`, `list_recent_files`, `get_storage_quota`, etc.)
+- `tools/drive/files.py` — file/folder operations (`create_spreadsheet`, `import_csv_to_sheet`, `list_spreadsheets`, `list_files`, `search_files`, `create_folder`, `copy_file`, `move_file`, `rename_file`, `delete_file`, `list_shared_with_me`, `list_recent_files`, `get_storage_quota`, etc.)
 - `tools/drive/sharing.py` — permissions (`share_spreadsheet`, `share_file`, `list_permissions`, `update_permission`, `remove_permission`)
 - `tools/drive/transfer.py` — upload/download/sync/export/revisions
 - `tools/drive/activity.py` — `list_file_activity` (Drive Activity API v2; requires `drive.activity.readonly` scope)

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-gee-sweet
-Version: 0.7.0.dev70
+Version: 0.7.0.dev72
 Summary: MCP server for Google Workspace — Sheets, Drive, Docs, and Calendar. 60+ tools for AI clients.
 Project-URL: Homepage, https://github.com/khuisman/mcp-gee-sweet
 Project-URL: Bug Tracker, https://github.com/khuisman/mcp-gee-sweet/issues

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/docs/configuration.md

@@ -69,7 +69,7 @@ Access logs are emitted at `INFO` level — they appear when `DEBUG_LEVEL` is `D
 
 <!-- Auto-generated by `scripts/gen_tool_docs.py` — do not edit by hand, your changes will be overwritten on the next commit. -->
 
-By default all 89 tools are registered. Use `ENABLED_TOOLS` (or `--include-tools` on the CLI) to restrict the server to exactly the tools you need. This reduces the AI's context window cost — each registered tool is a name the model must reason about on every call.
+By default all 90 tools are registered. Use `ENABLED_TOOLS` (or `--include-tools` on the CLI) to restrict the server to exactly the tools you need. This reduces the AI's context window cost — each registered tool is a name the model must reason about on every call.
 
 ```bash
 # Environment variable
@@ -90,7 +90,7 @@ get_sheet_data,get_sheet_formulas,get_multiple_sheet_data,get_multiple_spreadshe
 
 **Sheets read + write:**
 ```
-get_sheet_data,get_sheet_formulas,get_multiple_sheet_data,get_multiple_spreadsheet_summary,find_in_spreadsheet,list_sheets,list_spreadsheets,update_cells,batch_update_cells,create_sheet,rename_sheet,add_rows,add_columns
+get_sheet_data,get_sheet_formulas,get_multiple_sheet_data,get_multiple_spreadsheet_summary,find_in_spreadsheet,list_sheets,list_spreadsheets,update_cells,batch_update_cells,create_sheet,rename_sheet,add_rows,add_columns,import_csv_to_sheet
 ```
 
 **Docs only:**

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/docs/qa/tests/drive.md

@@ -2015,3 +2015,86 @@ Exporting even the small QA fixture spreadsheet as `xlsx` immediately exceeded t
 **Background:** `list_file_activity` is already Drive-API-paginated (`page_size` clamped 1–100) and low per-item size — the only realistic exposure is a single activity's `actors` list ballooning on a file with many collaborators. Per the #242 decision doc, this tool intentionally did NOT get a dedicated live-fixture verification (reproducing hundreds of real Drive Activity events isn't cheaply reproducible) — the cap was added for defense-in-depth only, verified by unit tests (`tests/drive/test_activity.py::TestListFileActivity::test_oversized_result_raises`, `test_error_points_to_page_size_not_local_path`).
 
 **Result (2026-07-03) ✅ N/A (by design)** — sanity-checked live that the tool still functions normally post-change (`list_file_activity(file_id={SPREADSHEET_ID}, page_size=5)` returned a normal activity list, no regression). Cap-triggering behavior covered by unit tests only, not live-verified — documented scoping decision, not an oversight.
+
+---
+
+## `import_csv_to_sheet` (issue #187)
+
+### TC-D169: Basic import creates a populated spreadsheet ⚠️ requires-oauth ⚠️ local-filesystem
+**Prompt**
+> "Import the CSV at `/tmp/qa-import.csv` into a new spreadsheet called 'QA-CSV-Import' in {FOLDER_ID}" *(create `/tmp/qa-import.csv` first with a header row and 3-4 data rows, e.g. `name,age\nAlice,30\nBob,25`)*
+
+**Checks**
+- Response includes `spreadsheetId`, `title` exactly 'QA-CSV-Import', `web_link`, and `rows_written` matching the CSV's row count (including header)
+- `get_sheet_data` on the new spreadsheet's default sheet returns the same rows, in order
+- `drive_folder_cache.mark_dirty` fired — `list_files` on {FOLDER_ID} shows the new spreadsheet without a manual refresh
+
+**Result (2026-07-05) ✅ PASS** Created spreadsheet with `rows_written: 4`, exact title, and a `web_link`. `get_sheet_data` returned `[["name","age"],["Alice","30"],["Bob","25"],["Carol","42"]]` — matches the source CSV exactly. `list_files` on `{FOLDER_ID}` showed the new spreadsheet immediately, confirming the folder cache invalidation.
+
+---
+
+### TC-D170: Custom sheet_name renames the default sheet ⚠️ requires-oauth ⚠️ local-filesystem
+**Prompt**
+> "Import `/tmp/qa-import.csv` into a new spreadsheet called 'QA-CSV-SheetName', writing to a sheet named 'Imported Data'"
+
+**Checks**
+- `list_sheets` on the new spreadsheet shows exactly one sheet, named 'Imported Data' (not the default 'Sheet1')
+- Data is present on that sheet via `get_sheet_data`
+
+**Result (2026-07-05) ✅ PASS** `list_sheets` returned exactly `["Imported Data"]` — the default 'Sheet1' was renamed, not left as a second sheet. `get_sheet_data(sheet="Imported Data")` returned all 4 rows intact.
+
+---
+
+### TC-D171: Grid auto-expands beyond the default 1000-row limit ⚠️ requires-oauth ⚠️ local-filesystem
+**Prompt**
+> "Import `/tmp/qa-import-large.csv` into a new spreadsheet called 'QA-CSV-Large'" *(generate a CSV with 1500+ rows first, e.g. a header plus 1500 numbered rows)*
+
+**Checks**
+- Call succeeds without a grid-limit error (the documented pre-fix failure mode from the issue)
+- `rows_written` matches the CSV's row count
+- `get_sheet_data` confirms the last row of data is present and readable (not silently truncated at row 1000)
+
+**Result (2026-07-05) ✅ PASS** Imported a 1501-row CSV (header + 1500 numbered rows) with no grid-limit error — `rows_written: 1501`. Fetched `A999:B1501` and confirmed rows 998–1500 are all present and correctly ordered, including the final row `["1500","row-1500"]` — no truncation at the default 1000-row boundary.
+
+---
+
+### TC-D172: Ragged rows padded to a common width ⚠️ requires-oauth ⚠️ local-filesystem
+**Prompt**
+> "Import `/tmp/qa-import-ragged.csv` into a new spreadsheet called 'QA-CSV-Ragged'" *(create a CSV where some rows have fewer columns than others, e.g. `a,b,c\n1,2\n`)*
+
+**Checks**
+- No dropped or misaligned rows in `get_sheet_data` — short rows are padded with empty cells rather than shifted
+- `rows_written` counts every row, including the short one
+
+**Result (2026-07-05) ✅ PASS** CSV `a,b,c / 1,2 / 4,5,6` (middle row missing column `c`) imported with `rows_written: 3`. `get_sheet_data` returned `[["a","b","c"],["1","2"],["4","5","6"]]` — the short row landed under columns a/b with no shift, and the third row wasn't dropped. (Sheets' values.get omits the trailing empty string we pad with, which is expected — the important signal is correct alignment, not a literal empty-string round-trip.)
+
+---
+
+### TC-D173: Non-existent local path (unit test)
+
+**Checks (unit test)**
+- Missing `local_path` returns `{"error": "..."}` mentioning the path — no Drive API call made
+
+**Result:** ✅ Unit test `test_file_not_found_returns_error` confirms this — no live Drive call needed since the function returns before touching `ctx`.
+
+---
+
+### TC-D174: Non-.csv extension rejected (unit test)
+
+**Checks (unit test)**
+- A `.txt` (or other non-.csv) file returns `{"error": "..."}` mentioning `.csv`, without calling the Drive API
+
+**Result:** ✅ Unit test `test_unsupported_extension_returns_error` confirms this.
+
+---
+
+### TC-D175: Service account Drive limitation
+
+**Prompt**
+> "Import `/tmp/qa-import.csv` into a new spreadsheet called 'QA-CSV-SA-Limit' — I want to verify whether the service account can create in personal Drive"
+
+**Checks**
+- 🔍 **Known limitation:** same as `create_spreadsheet` (TC-D04) — service account cannot create in personal Drive, only shared folders it has access to
+- Unit-level equivalent already covered: `test_storage_quota_error_returns_helpful_message`
+
+**Result (2026-07-05) ✅ PASS** Against the service-account server (`mcp-gee-sweet-sa`), the call returned `{"error": "Service accounts cannot create or copy files in personal Drive (no storage quota). Use OAuth or ADC auth for full Drive write access, or use a Shared Drive destination. Check server://auth-status for your current auth method and affected tools."}` — the same `_SA_QUOTA_ERROR` message `create_spreadsheet` returns, confirming the shared error path works for this tool too.

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/docs/tools.md

@@ -2,7 +2,7 @@
 
 <!-- Auto-generated by `scripts/gen_tool_docs.py` — do not edit by hand, your changes will be overwritten on the next commit. -->
 
-89 tools. All tool names are lowercase with underscores — use these exact strings with `ENABLED_TOOLS` or `--include-tools`.
+90 tools. All tool names are lowercase with underscores — use these exact strings with `ENABLED_TOOLS` or `--include-tools`.
 
 ## Sheets — data
 
@@ -47,6 +47,7 @@
 | Tool | Description | Key parameters |
 |---|---|---|
 | `create_spreadsheet` | Create a new Google Spreadsheet. | `title`, `folder_id?` |
+| `import_csv_to_sheet` | Create a new Google Spreadsheet populated from a local CSV file. | `local_path`, `title`, `folder_id?`, `sheet_name?` |
 | `list_spreadsheets` | List all spreadsheets in the specified Google Drive folder. If no folder is specified, uses the configured default folder or lists from 'My Drive'. | `folder_id?` |
 | `search_spreadsheets` | Search for spreadsheets in Google Drive by name or content. | `query`, `max_results?` |
 

mcp_gee_sweet-0.7.0.dev72/pyrightconfig.json

@@ -0,0 +1,4 @@
+{
+  "venvPath": ".",
+  "venv": ".venv"
+}

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/scripts/gen_tool_docs.py

@@ -97,7 +97,13 @@ SECTIONS = [
         "Spreadsheets (Drive-level)",
         lambda f: (
             f.__module__ == "mcp_gee_sweet.tools.drive.files"
-            and f.__name__ in {"create_spreadsheet", "list_spreadsheets", "search_spreadsheets"}
+            and f.__name__
+            in {
+                "create_spreadsheet",
+                "list_spreadsheets",
+                "search_spreadsheets",
+                "import_csv_to_sheet",
+            }
         ),
         "`create_spreadsheet` cannot create files in a personal Drive when using "
         "service account auth — use OAuth or a Shared Drive.",
@@ -106,7 +112,13 @@ SECTIONS = [
         "Drive — files",
         lambda f: (
             f.__module__ == "mcp_gee_sweet.tools.drive.files"
-            and f.__name__ not in {"create_spreadsheet", "list_spreadsheets", "search_spreadsheets"}
+            and f.__name__
+            not in {
+                "create_spreadsheet",
+                "list_spreadsheets",
+                "search_spreadsheets",
+                "import_csv_to_sheet",
+            }
         ),
         None,
     ),
@@ -194,6 +206,7 @@ SUBSETS = [
             "rename_sheet",
             "add_rows",
             "add_columns",
+            "import_csv_to_sheet",
         ],
     ),
     (

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/src/mcp_gee_sweet/tools/drive/files.py

@@ -1,15 +1,20 @@
+import csv
 import logging
 from datetime import datetime, timedelta, timezone
+from pathlib import Path
 from typing import Any
 
 from googleapiclient.errors import HttpError
 from mcp.server.fastmcp import Context
 from mcp.types import ToolAnnotations
 
+from ..sheets.helpers import _quote_sheet_name
 from . import _SA_QUOTA_ERROR
 
 logger = logging.getLogger(__name__)
 
+_CSV_IMPORT_CHUNK_ROWS = 5000
+
 
 def register(tool):
     @tool(annotations=ToolAnnotations(title="Create Spreadsheet", destructiveHint=True))
@@ -71,6 +76,155 @@ def register(tool):
             "folder": parents[0] if parents else "root",
         }
 
+    @tool(annotations=ToolAnnotations(title="Import CSV to Sheet", destructiveHint=True))
+    def import_csv_to_sheet(
+        local_path: str,
+        title: str,
+        folder_id: str | None = None,
+        sheet_name: str = "Sheet1",
+        ctx: Context = None,
+    ) -> dict[str, Any]:
+        """
+        Create a new Google Spreadsheet populated from a local CSV file.
+
+        Reads the CSV, creates the spreadsheet, expands the sheet's grid to fit
+        the data (avoiding the default 1000-row/26-column limit), and writes
+        every row in one or more batched value updates.
+
+        Args:
+            local_path: Absolute path to the local .csv file.
+            title: Title for the new spreadsheet.
+            folder_id: Optional Google Drive folder ID where the spreadsheet should
+                      be created. If not provided, uses the configured default
+                      folder or creates in root.
+            sheet_name: Name of the sheet the data is written to (default "Sheet1").
+
+        Returns:
+            spreadsheetId, title, web_link, and rows_written.
+
+        Note:
+            Requires OAuth or ADC auth. Service accounts cannot create files in personal
+            Drive (no storage quota). Works on Shared Drives regardless of auth method.
+            Check server://auth-status for your current auth method.
+        """
+        path = Path(local_path)
+        if not path.exists():
+            return {"error": f"File not found: {local_path}"}
+        if path.suffix.lower() != ".csv":
+            return {"error": f"Unsupported file extension '{path.suffix}'. Use .csv"}
+
+        with path.open(newline="", encoding="utf-8") as f:
+            rows = list(csv.reader(f))
+
+        if not rows:
+            return {"error": f"CSV file is empty: {local_path}"}
+
+        width = max(len(row) for row in rows)
+        rows = [row + [""] * (width - len(row)) for row in rows]
+
+        lc = ctx.request_context.lifespan_context
+        drive_service = lc.drive_service
+        sheets_service = lc.sheets_service
+        target_folder_id = folder_id or lc.folder_id
+
+        file_body = {"name": title, "mimeType": "application/vnd.google-apps.spreadsheet"}
+        if target_folder_id:
+            file_body["parents"] = [target_folder_id]
+
+        try:
+            spreadsheet = (
+                drive_service.files()
+                .create(
+                    supportsAllDrives=True,
+                    body=file_body,
+                    fields="id, name, parents, webViewLink",
+                )
+                .execute()
+            )
+        except HttpError as e:
+            if e.resp.status == 403 and b"storageQuotaExceeded" in (e.content or b""):
+                return {"error": _SA_QUOTA_ERROR}
+            raise
+
+        spreadsheet_id = spreadsheet.get("id")
+        target_folder_id = target_folder_id or (spreadsheet.get("parents", [None])[0])
+
+        default_sheet = (
+            sheets_service.spreadsheets()
+            .get(
+                spreadsheetId=spreadsheet_id,
+                fields="sheets(properties(sheetId,title,gridProperties))",
+            )
+            .execute()
+            .get("sheets", [{}])[0]
+        )
+        default_props = default_sheet.get("properties", {})
+        sheet_id = default_props.get("sheetId", 0)
+        default_title = default_props.get("title")
+        grid = default_props.get("gridProperties", {})
+
+        requests: list[dict[str, Any]] = []
+        if default_title != sheet_name:
+            requests.append(
+                {
+                    "updateSheetProperties": {
+                        "properties": {"sheetId": sheet_id, "title": sheet_name},
+                        "fields": "title",
+                    }
+                }
+            )
+        needed_rows, needed_cols = len(rows), width
+        if needed_rows > grid.get("rowCount", 1000) or needed_cols > grid.get("columnCount", 26):
+            requests.append(
+                {
+                    "updateSheetProperties": {
+                        "properties": {
+                            "sheetId": sheet_id,
+                            "gridProperties": {
+                                "rowCount": max(needed_rows, grid.get("rowCount", 1000)),
+                                "columnCount": max(needed_cols, grid.get("columnCount", 26)),
+                            },
+                        },
+                        "fields": "gridProperties.rowCount,gridProperties.columnCount",
+                    }
+                }
+            )
+
+        if requests:
+            sheets_service.spreadsheets().batchUpdate(
+                spreadsheetId=spreadsheet_id, body={"requests": requests}
+            ).execute()
+            lc.cache.mark_dirty(spreadsheet_id)
+
+        quoted_sheet = _quote_sheet_name(sheet_name)
+        for start in range(0, len(rows), _CSV_IMPORT_CHUNK_ROWS):
+            chunk = rows[start : start + _CSV_IMPORT_CHUNK_ROWS]
+            sheets_service.spreadsheets().values().update(
+                spreadsheetId=spreadsheet_id,
+                range=f"{quoted_sheet}!A{start + 1}",
+                valueInputOption="USER_ENTERED",
+                body={"values": chunk},
+            ).execute()
+
+        if target_folder_id:
+            lc.drive_folder_cache.mark_dirty(target_folder_id)
+        lc.sheet_data_cache.mark_dirty(spreadsheet_id)
+
+        logger.debug(
+            "Imported CSV %s into spreadsheet %s (%d rows, %d cols)",
+            local_path,
+            spreadsheet_id,
+            len(rows),
+            width,
+        )
+
+        return {
+            "spreadsheetId": spreadsheet_id,
+            "title": spreadsheet.get("name", title),
+            "web_link": spreadsheet.get("webViewLink"),
+            "rows_written": len(rows),
+        }
+
     @tool(annotations=ToolAnnotations(title="List Spreadsheets", readOnlyHint=True))
     def list_spreadsheets(
         folder_id: str | None = None, ctx: Context = None

{mcp_gee_sweet-0.7.0.dev70 → mcp_gee_sweet-0.7.0.dev72}/tests/drive/test_files.py

@@ -344,3 +344,227 @@ class TestGetStorageQuota:
         fields_arg = svc.about.return_value.get.call_args.kwargs["fields"]
         assert "storageQuota" in fields_arg
         assert "user" in fields_arg
+
+
+class TestImportCsvToSheet:
+    """import_csv_to_sheet: create a spreadsheet from a local CSV file."""
+
+    def _drive_service(self):
+        mock = MagicMock()
+        mock.files.return_value.create.return_value.execute.return_value = {
+            "id": "sheet123",
+            "name": "Imported",
+            "parents": ["folder1"],
+            "webViewLink": "https://docs.google.com/spreadsheets/d/sheet123",
+        }
+        return mock
+
+    def _sheets_service(self, sheet_title="Sheet1", row_count=1000, column_count=26):
+        mock = MagicMock()
+        mock.spreadsheets.return_value.get.return_value.execute.return_value = {
+            "sheets": [
+                {
+                    "properties": {
+                        "sheetId": 0,
+                        "title": sheet_title,
+                        "gridProperties": {
+                            "rowCount": row_count,
+                            "columnCount": column_count,
+                        },
+                    }
+                }
+            ]
+        }
+        mock.spreadsheets.return_value.batchUpdate.return_value.execute.return_value = {}
+        mock.spreadsheets.return_value.values.return_value.update.return_value.execute.return_value = {}
+        return mock
+
+    def _write_csv(self, tmp_path, rows, name="data.csv"):
+        path = tmp_path / name
+        path.write_text("\n".join(",".join(row) for row in rows) + "\n", encoding="utf-8")
+        return path
+
+    def test_file_not_found_returns_error(self):
+        ctx = _make_ctx()
+        result = _drive_tools["import_csv_to_sheet"](
+            local_path="/no/such/file.csv", title="X", ctx=ctx
+        )
+        assert "error" in result
+        assert "not found" in result["error"].lower()
+
+    def test_unsupported_extension_returns_error(self, tmp_path):
+        path = tmp_path / "data.txt"
+        path.write_text("a,b\n1,2\n", encoding="utf-8")
+        ctx = _make_ctx()
+        result = _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)
+        assert "error" in result
+        assert ".csv" in result["error"]
+
+    def test_empty_csv_returns_error(self, tmp_path):
+        path = tmp_path / "empty.csv"
+        path.write_text("", encoding="utf-8")
+        ctx = _make_ctx()
+        result = _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)
+        assert "error" in result
+        assert "empty" in result["error"].lower()
+
+    def test_creates_spreadsheet_and_writes_rows(self, tmp_path):
+        path = self._write_csv(tmp_path, [["name", "age"], ["Alice", "30"], ["Bob", "25"]])
+        drive_svc = self._drive_service()
+        sheets_svc = self._sheets_service()
+        folder_cache = MagicMock()
+        sheet_data_cache = MagicMock()
+        ctx = _make_ctx(
+            drive_service=drive_svc,
+            sheets_service=sheets_svc,
+            drive_folder_cache=folder_cache,
+            sheet_data_cache=sheet_data_cache,
+            folder_id=None,
+        )
+        result = _drive_tools["import_csv_to_sheet"](
+            local_path=str(path), title="Imported", folder_id="folder1", ctx=ctx
+        )
+
+        assert result["spreadsheetId"] == "sheet123"
+        assert result["title"] == "Imported"
+        assert result["web_link"] == "https://docs.google.com/spreadsheets/d/sheet123"
+        assert result["rows_written"] == 3
+
+        update_call = sheets_svc.spreadsheets.return_value.values.return_value.update
+        assert update_call.call_count == 1
+        kwargs = update_call.call_args.kwargs
+        assert kwargs["spreadsheetId"] == "sheet123"
+        assert kwargs["range"] == "Sheet1!A1"
+        assert kwargs["valueInputOption"] == "USER_ENTERED"
+        assert kwargs["body"]["values"] == [
+            ["name", "age"],
+            ["Alice", "30"],
+            ["Bob", "25"],
+        ]
+        folder_cache.mark_dirty.assert_called_once_with("folder1")
+        sheet_data_cache.mark_dirty.assert_called_once_with("sheet123")
+        # No resize/rename needed — default title matches, data fits default grid.
+        sheets_svc.spreadsheets.return_value.batchUpdate.assert_not_called()
+
+    def test_pads_ragged_rows_to_common_width(self, tmp_path):
+        path = tmp_path / "ragged.csv"
+        path.write_text("a,b,c\n1,2\n", encoding="utf-8")
+        drive_svc = self._drive_service()
+        sheets_svc = self._sheets_service()
+        ctx = _make_ctx(
+            drive_service=drive_svc,
+            sheets_service=sheets_svc,
+            drive_folder_cache=MagicMock(),
+            sheet_data_cache=MagicMock(),
+            folder_id=None,
+        )
+        _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)
+        kwargs = sheets_svc.spreadsheets.return_value.values.return_value.update.call_args.kwargs
+        assert kwargs["body"]["values"] == [["a", "b", "c"], ["1", "2", ""]]
+
+    def test_renames_default_sheet_when_sheet_name_differs(self, tmp_path):
+        path = self._write_csv(tmp_path, [["a"], ["1"]])
+        drive_svc = self._drive_service()
+        sheets_svc = self._sheets_service(sheet_title="Sheet1")
+        ctx = _make_ctx(
+            drive_service=drive_svc,
+            sheets_service=sheets_svc,
+            drive_folder_cache=MagicMock(),
+            sheet_data_cache=MagicMock(),
+            cache=MagicMock(),
+            folder_id=None,
+        )
+        _drive_tools["import_csv_to_sheet"](
+            local_path=str(path), title="X", sheet_name="Imported Data", ctx=ctx
+        )
+        requests = sheets_svc.spreadsheets.return_value.batchUpdate.call_args.kwargs["body"][
+            "requests"
+        ]
+        assert requests[0]["updateSheetProperties"]["properties"]["title"] == "Imported Data"
+        assert requests[0]["updateSheetProperties"]["properties"]["sheetId"] == 0
+        assert requests[0]["updateSheetProperties"]["fields"] == "title"
+        update_range = (
+            sheets_svc.spreadsheets.return_value.values.return_value.update.call_args.kwargs[
+                "range"
+            ]
+        )
+        assert update_range == "'Imported Data'!A1"
+
+    def test_resizes_grid_when_data_exceeds_default(self, tmp_path):
+        path = self._write_csv(tmp_path, [["a"], ["1"], ["2"], ["3"]])
+        drive_svc = self._drive_service()
+        # Force a resize by mocking a grid smaller than our 4-row CSV.
+        sheets_svc = self._sheets_service(row_count=1, column_count=1)
+        cache = MagicMock()
+        ctx = _make_ctx(
+            drive_service=drive_svc,
+            sheets_service=sheets_svc,
+            drive_folder_cache=MagicMock(),
+            sheet_data_cache=MagicMock(),
+            cache=cache,
+            folder_id=None,
+        )
+        _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)
+        requests = sheets_svc.spreadsheets.return_value.batchUpdate.call_args.kwargs["body"][
+            "requests"
+        ]
+        resize_req = next(
+            r for r in requests if "gridProperties" in r["updateSheetProperties"]["properties"]
+        )
+        grid = resize_req["updateSheetProperties"]["properties"]["gridProperties"]
+        assert grid["rowCount"] == 4
+        assert grid["columnCount"] == 1
+        cache.mark_dirty.assert_called_once_with("sheet123")
+
+    def test_no_resize_when_data_fits_default_grid(self, tmp_path):
+        path = self._write_csv(tmp_path, [["a", "b"], ["1", "2"]])
+        drive_svc = self._drive_service()
+        sheets_svc = self._sheets_service(row_count=1000, column_count=26)
+        cache = MagicMock()
+        ctx = _make_ctx(
+            drive_service=drive_svc,
+            sheets_service=sheets_svc,
+            drive_folder_cache=MagicMock(),
+            sheet_data_cache=MagicMock(),
+            cache=cache,
+            folder_id=None,
+        )
+        _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)
+        sheets_svc.spreadsheets.return_value.batchUpdate.assert_not_called()
+        cache.mark_dirty.assert_not_called()
+
+    def test_chunks_large_row_counts(self, tmp_path, monkeypatch):
+        monkeypatch.setattr(drive_files_module, "_CSV_IMPORT_CHUNK_ROWS", 2)
+        rows = [["a"]] + [[str(i)] for i in range(5)]
+        path = self._write_csv(tmp_path, rows)
+        drive_svc = self._drive_service()
+        sheets_svc = self._sheets_service()
+        ctx = _make_ctx(
+            drive_service=drive_svc,
+            sheets_service=sheets_svc,
+            drive_folder_cache=MagicMock(),
+            sheet_data_cache=MagicMock(),
+            folder_id=None,
+        )
+        result = _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)
+        assert result["rows_written"] == 6
+        update_call = sheets_svc.spreadsheets.return_value.values.return_value.update
+        assert update_call.call_count == 3
+        ranges = [c.kwargs["range"] for c in update_call.call_args_list]
+        assert ranges == ["Sheet1!A1", "Sheet1!A3", "Sheet1!A5"]
+
+    def test_storage_quota_error_returns_helpful_message(self, tmp_path):
+        path = self._write_csv(tmp_path, [["a"], ["1"]])
+        drive_svc = MagicMock()
+        drive_svc.files.return_value.create.return_value.execute.side_effect = _quota_http_error()
+        ctx = _make_ctx(drive_service=drive_svc, sheets_service=MagicMock(), folder_id=None)
+        result = _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)
+        assert result["error"] == drive_files_module._SA_QUOTA_ERROR
+
+    def test_other_403_error_reraises(self, tmp_path):
+        path = self._write_csv(tmp_path, [["a"], ["1"]])
+        drive_svc = MagicMock()
+        drive_svc.files.return_value.create.return_value.execute.side_effect = _other_403_error()
+        ctx = _make_ctx(drive_service=drive_svc, sheets_service=MagicMock(), folder_id=None)
+        with pytest.raises(HttpError):
+            _drive_tools["import_csv_to_sheet"](local_path=str(path), title="X", ctx=ctx)