Skip to content

Commit ec88450

Browse files
ARHAEEMclaude
andcommitted
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>
1 parent b2a7132 commit ec88450

2 files changed

Lines changed: 6 additions & 4 deletions

File tree

packages/mcp-server/README.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -379,7 +379,7 @@ npx airtable-user-mcp daemon status Show daemon status and port (JSON)
379379
| `rename_table` | Rename a table |
380380
| `delete_table` | Delete a table (requires `expectedName` safety guard) |
381381

382-
### Field Management (8)
382+
### Field Management (9)
383383

384384
| Tool | Description |
385385
|:-----|:------------|
@@ -389,6 +389,7 @@ npx airtable-user-mcp daemon status Show daemon status and port (JSON)
389389
| `update_field_config` | Update configuration of any computed field |
390390
| `rename_field` | Rename a field with pre-validation |
391391
| `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. |
392393
| `duplicate_field` | Clone a field, optionally copying cell values |
393394
| `update_field_description` | Set or update a field's description text |
394395

@@ -501,9 +502,10 @@ Args: {
501502

502503
## Safety
503504

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
505+
- **Destructive operations** (`delete_table`, `delete_field`, `delete_fields`, `delete_view`, `remove_extension`) include built-in safety guards
506+
- `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
506507
- `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.
507509
- Formula validation is available and recommended before creating/updating formulas
508510
- All tools accept `debug: true` for raw response inspection
509511

packages/webview/src/tabs/Settings.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -572,7 +572,7 @@ export function Settings() {
572572
<SettingToggle label="Table Write" desc="Tables + record templates: create / rename / update / set cells / duplicate / apply (9 tools)" value={settings.mcp.toolProfile.categories.tableWrite} settingKey="mcp.categories.tableWrite" />
573573
<SettingToggle label="Table Destructive" desc="delete_table, delete_record_template (2 tools)" value={settings.mcp.toolProfile.categories.tableDestructive} settingKey="mcp.categories.tableDestructive" />
574574
<SettingToggle label="Field Write" desc="Create / update / rename / duplicate fields (7 tools)" value={settings.mcp.toolProfile.categories.fieldWrite} settingKey="mcp.categories.fieldWrite" />
575-
<SettingToggle label="Field Destructive" desc="delete_field (1 tool)" value={settings.mcp.toolProfile.categories.fieldDestructive} settingKey="mcp.categories.fieldDestructive" />
575+
<SettingToggle label="Field Destructive" desc="delete_field, delete_fields (2 tools)" value={settings.mcp.toolProfile.categories.fieldDestructive} settingKey="mcp.categories.fieldDestructive" />
576576
<SettingToggle label="View Write" desc="Views, filters, sorts, columns, freezing, covers, calendar dates (19 tools)" value={settings.mcp.toolProfile.categories.viewWrite} settingKey="mcp.categories.viewWrite" />
577577
<SettingToggle label="View Destructive" desc="delete_view (1 tool)" value={settings.mcp.toolProfile.categories.viewDestructive} settingKey="mcp.categories.viewDestructive" />
578578
<SettingToggle label="View Sections" desc="Sidebar grouping: create / rename / move (3 tools)" value={settings.mcp.toolProfile.categories.viewSection} settingKey="mcp.categories.viewSection" />

0 commit comments

Comments
 (0)