You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: document delete_fields in README and Settings UI
- packages/mcp-server/README.md: add delete_fields to Field Management
table (8→9 tools) and Safety section
- packages/webview/src/tabs/Settings.tsx: Field Destructive label now
shows "delete_field, delete_fields (2 tools)"
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: packages/mcp-server/README.md
+5-3Lines changed: 5 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -379,7 +379,7 @@ npx airtable-user-mcp daemon status Show daemon status and port (JSON)
379
379
|`rename_table`| Rename a table |
380
380
|`delete_table`| Delete a table (requires `expectedName` safety guard) |
381
381
382
-
### Field Management (8)
382
+
### Field Management (9)
383
383
384
384
| Tool | Description |
385
385
|:-----|:------------|
@@ -389,6 +389,7 @@ npx airtable-user-mcp daemon status Show daemon status and port (JSON)
389
389
|`update_field_config`| Update configuration of any computed field |
390
390
|`rename_field`| Rename a field with pre-validation |
391
391
|`delete_field`| Delete with safety guards and a compact dependency summary |
392
+
|`delete_fields`| Bulk-delete multiple fields in 1–2 API calls. Takes a `fields` array of `{fieldId, expectedName}` pairs; validates names before deleting. Use `force: true` to override dependency blocks. Optional `checkpointFile` writes progress after each batch so interrupted runs can resume. |
392
393
|`duplicate_field`| Clone a field, optionally copying cell values |
393
394
|`update_field_description`| Set or update a field's description text |
394
395
@@ -501,9 +502,10 @@ Args: {
501
502
502
503
## Safety
503
504
504
-
-**Destructive operations** (`delete_table`, `delete_field`, `delete_view`, `remove_extension`) include built-in safety guards
505
-
-`delete_table`and `delete_field` both require an `expectedName`parameter that must match the current name exactly — prevents accidentally deleting the wrong object after a rename
-`delete_table`, `delete_field`, and each entry in `delete_fields` all require an `expectedName` that must match the current field name exactly — prevents accidentally deleting the wrong object after a rename
506
507
-`delete_field` checks for downstream dependencies and returns a compact summary (`viewGroupings`, `viewSorts`, `viewFilters`, `fields`) before committing; set `force: true` to delete anyway
508
+
-`delete_fields` is the preferred tool for bulk deletion (dozens to hundreds of fields). It uses Airtable's native batch endpoint, so N fields from the same table cost 1–2 API calls instead of N×3. Set `force: true` to delete even fields with downstream dependencies.
507
509
- Formula validation is available and recommended before creating/updating formulas
508
510
- All tools accept `debug: true` for raw response inspection
0 commit comments