Browse Airtable bases and tables, inspect records, create records, and manage fields, comments, and table actions via the Airtable API. Use this skill when users want to read or write data in Airtable, manage base schemas, or automate record operations.
Browse Airtable bases and tables, inspect records, create records, and manage fields, comments, and table actions via the Airtable API. Use this skill when users want to read or write data in Airtable, manage base schemas, or automate record operations.
Airtable
Work with Airtable from chat — browse bases and tables, read and create records, manage fields, comments, and table operations via the Airtable API with OAuth authentication.
This skill uses ClawLink for hosted connection flows and credentials so you do not need to configure Airtable API access yourself.
Install the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.
Then tell the user: "OpenClaw has been restarted. Send /new as a standalone message to start a fresh chat, then ask for Airtable again."
Quick Start
# List all accessible bases
clawlink_call_tool --tool "airtable_list_bases" --params '{}'# Get base schema (tables and fields)
clawlink_call_tool --tool "airtable_get_base_schema" --params '{"base_id": "YOUR_BASE_ID"}'# List records from a table
clawlink_call_tool --tool "airtable_list_records" --params '{"base_id": "YOUR_BASE_ID", "table_id": "YOUR_TABLE_ID", "max_records": 20}'
Authentication
All Airtable tool calls are authenticated automatically by ClawLink using the user's connected Airtable account.
No API key is required in chat. ClawLink stores the OAuth token securely and injects it into every Airtable API request on the user's behalf.
Getting Connected
Install the ClawLink plugin (see Install above).
Pair the plugin with clawlink_begin_pairing if it is not configured yet.
After they confirm, call clawlink_list_integrations to verify
Then call clawlink_list_tools --integration airtable
Security& Permissions
Access is scoped to the bases and tables accessible to the connected Airtable account.
All write operations require explicit user confirmation. Before executing any create, update, or delete call, confirm the target resource and intended effect with the user.
Destructive actions (delete record, delete multiple records, delete field) are marked as high-impact and must be confirmed.
Record deletion is permanent and cannot be undone.
Tool Reference
Base & Schema Operations
Tool
Description
Mode
airtable_list_bases
List all Airtable bases accessible to the authenticated user
Read
airtable_get_base_schema
Get detailed schema for a base including tables and fields
Read
airtable_create_base
Create a new Airtable base with tables and fields
Write
airtable_create_table
Add a new table to an existing base
Write
airtable_update_table
Update table name, description, or date dependency settings
Write
Record Operations
Tool
Description
Mode
airtable_list_records
List records from a table with filtering, sorting, and pagination
Read
airtable_get_record
Retrieve a specific record by its record ID
Read
airtable_create_records
Create up to 10 new records in a table
Write
airtable_create_record_from_natural_language
Create a record from a natural language description
Write
airtable_update_record
Update specific fields of an existing record
Write
airtable_update_multiple_records
Update up to 10 records with partial field modifications
Write
airtable_delete_record
Permanently delete a single record
Write
airtable_delete_multiple_records
Delete up to 10 records in one operation
Write
Field Operations
Tool
Description
Mode
airtable_create_field
Add a new field to a table
Write
airtable_update_field
Update a field's name or description
Write
Comment Operations
Tool
Description
Mode
airtable_list_comments
List comments on a specific record
Read
airtable_create_comment
Add a comment to a record, with optional threaded replies
Write
airtable_update_comment
Update an existing comment's text
Write
airtable_delete_comment
Delete a comment from a record
Write
Attachment Operations
Tool
Description
Mode
airtable_upload_attachment
Upload a file attachment to a record field (base64-encoded)
Write
User Info
Tool
Description
Mode
airtable_get_user_info
Get the authenticated user's ID and permission scopes
┌─────────────────────────────────────────────────────────────┐
│ READ OPERATIONS (Safe) │
│ list → get → search → describe → call │
│ │
│ Example: List bases → Get schema → List records → Show │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ WRITE OPERATIONS (Require Confirmation) │
│ list → get → describe → preview → confirm → call │
│ │
│ Example: Describe tool → Preview changes → User approves │
│ → Execute update │
└─────────────────────────────────────────────────────────────┘
For unfamiliar tools, ambiguous requests, or any write action, call clawlink_describe_tool first.
Use the returned guidance, schema, whenToUse, askBefore, safeDefaults, examples, and followups to shape the call.
Prefer read, list, search, and get operations before writes when that reduces ambiguity.
For writes or anything marked as requiring confirmation, call clawlink_preview_tool first.
Execute with clawlink_call_tool. Pass confirmation only after the preview matches the user's intent.
If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.
Notes
Base IDs start with app (e.g., appXXXXXXXXXXXXXX). Table IDs start with tbl. Record IDs start with rec.
Empty field values are not returned in API responses.
Attachments must be provided as base64-encoded strings.
Rate limit: 5 requests per second per base.
Maximum 10 records can be created or updated in a single batch operation.
Comments support threaded replies via parentCommentId.
Error Handling
Status / Error
Meaning
Tool not found
The tool name does not exist in the current catalog. Verify with clawlink_list_tools --integration airtable.
