update_view_description
Idempotent
Change a view's description in Airtable. Specify the new description text, or clear it with an empty string.
Instructions
Update the description text of a view.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | The Airtable base/application ID | |
| viewId | Yes | The view ID (e.g. "viwXXX") | |
| description | Yes | The new description text. Use empty string to clear. | |
| debug | No | When true, include raw Airtable response in output for diagnostics |
Implementation Reference
- MCP tool schema definition for update_view_description. Defines input parameters: appId (base ID), viewId (view ID), description (text to set, empty string to clear), and optional debug flag.
{ name: 'update_view_description', description: 'Update the description text of a view.', annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, inputSchema: { type: 'object', properties: { appId: { type: 'string', description: 'The Airtable base/application ID' }, viewId: { type: 'string', description: 'The view ID (e.g. "viwXXX")' }, description: { type: 'string', description: 'The new description text. Use empty string to clear.' }, debug: debugProp, }, required: ['appId', 'viewId', 'description'], }, }, - Handler function for the update_view_description tool. Delegates to client.updateViewDescription() and returns a success response with the viewId.
async update_view_description({ appId, viewId, description, debug }) { const result = await client.updateViewDescription(appId, viewId, description); return ok( { updated: true, viewId }, result, debug, ); }, - Client method that performs the actual HTTP call to Airtable's internal API. Validates IDs, POSTs to /v0.3/view/{viewId}/updateDescription with a description payload.
async updateViewDescription(appId, viewId, description) { assertAirtableId(appId, 'appId'); assertAirtableId(viewId, 'viewId'); const url = `https://airtable.com/v0.3/view/${viewId}/updateDescription`; const payload = { description }; const res = await this.auth.postForm(url, this._mutationParams(payload, appId), appId); if (!res.ok) { const errBody = await res.text().catch(() => ''); throw new Error(`updateViewDescription failed (${res.status}): ${errBody}`); } return res.json(); } - packages/mcp-server/src/tool-config.js:62-62 (registration)Tool category registration in TOOL_CATEGORIES — maps update_view_description to the 'view-write' permission category.
update_view_description: 'view-write',