{"id":"airtable-automation","name":"airtable-automation","summary":"Rube MCP(Composio)を使ってAirtableのタスクを自動化:レコード、ベース、テーブル、フィールド、ビュー。","body":"# Airtable Automation via Rube MCP\n\nAutomate Airtable operations through Composio's Airtable toolkit via Rube MCP.\n\n**Toolkit docs**: [composio.dev/toolkits/airtable](https://composio.dev/toolkits/airtable)\n\n## Prerequisites\n\n- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)\n- Active Airtable connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `airtable`\n- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas\n\n## Setup\n\n**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.\n\n\n1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds\n2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `airtable`\n3. If connection is not ACTIVE, follow the returned auth link to complete Airtable auth\n4. Confirm connection status shows ACTIVE before running any workflows\n\n## Core Workflows\n\n### 1. Create and Manage Records\n\n**When to use**: User wants to create, read, update, or delete records\n\n**Tool sequence**:\n1. `AIRTABLE_LIST_BASES` - Discover available bases [Prerequisite]\n2. `AIRTABLE_GET_BASE_SCHEMA` - Inspect table structure [Prerequisite]\n3. `AIRTABLE_LIST_RECORDS` - List/filter records [Optional]\n4. `AIRTABLE_CREATE_RECORD` / `AIRTABLE_CREATE_RECORDS` - Create records [Optional]\n5. `AIRTABLE_UPDATE_RECORD` / `AIRTABLE_UPDATE_MULTIPLE_RECORDS` - Update records [Optional]\n6. `AIRTABLE_DELETE_RECORD` / `AIRTABLE_DELETE_MULTIPLE_RECORDS` - Delete records [Optional]\n\n**Key parameters**:\n- `baseId`: Base ID (starts with 'app', e.g., 'appXXXXXXXXXXXXXX')\n- `tableIdOrName`: Table ID (starts with 'tbl') or table name\n- `fields`: Object mapping field names to values\n- `recordId`: Record ID (starts with 'rec') for updates/deletes\n- `filterByFormula`: Airtable formula for filtering\n- `typecast`: Set true for automatic type conversion\n\n**Pitfalls**:\n- pageSize capped at 100; uses offset pagination; changing filters between pages can skip/duplicate rows\n- CREATE_RECORDS hard limit of 10 records per request; chunk larger imports\n- Field names are CASE-SENSITIVE and must match schema exactly\n- 422 UNKNOWN_FIELD_NAME when field names are wrong; 403 for permission issues\n- INVALID_MULTIPLE_CHOICE_OPTIONS may require typecast=true\n\n### 2. Search and Filter Records\n\n**When to use**: User wants to find specific records using formulas\n\n**Tool sequence**:\n1. `AIRTABLE_GET_BASE_SCHEMA` - Verify field names and types [Prerequisite]\n2. `AIRTABLE_LIST_RECORDS` - Query with filterByFormula [Required]\n3. `AIRTABLE_GET_RECORD` - Get full record details [Optional]\n\n**Key parameters**:\n- `filterByFormula`: Airtable formula (e.g., `{Status}='Done'`)\n- `sort`: Array of sort objects\n- `fields`: Array of field names to return\n- `maxRecords`: Max total records across all pages\n- `offset`: Pagination cursor from previous response\n\n**Pitfalls**:\n- Field names in formulas must be wrapped in `{}` and match schema exactly\n- String values must be quoted: `{Status}='Active'` not `{Status}=Active`\n- 422 INVALID_FILTER_BY_FORMULA for bad syntax or non-existent fields\n- Airtable rate limit: ~5 requests/second per base; handle 429 with Retry-After\n\n### 3. Manage Fields and Schema\n\n**When to use**: User wants to create or modify table fields\n\n**Tool sequence**:\n1. `AIRTABLE_GET_BASE_SCHEMA` - Inspect current schema [Prerequisite]\n2. `AIRTABLE_CREATE_FIELD` - Create a new field [Optional]\n3. `AIRTABLE_UPDATE_FIELD` - Rename/describe a field [Optional]\n4. `AIRTABLE_UPDATE_TABLE` - Update table metadata [Optional]\n\n**Key parameters**:\n- `name`: Field name\n- `type`: Field type (singleLineText, number, singleSelect, etc.)\n- `options`: Type-specific options (choices for select, precision for number)\n- `description`: Field description\n\n**Pitfalls**:\n- UPDATE_FIELD only changes name/description, NOT type/options; create a replacement field and migrate\n- Computed fields (formula, rollup, lookup) cannot be created via API\n- 422 when type options are missing or malformed\n\n### 4. Manage Comments\n\n**When to use**: User wants to view or add comments on records\n\n**Tool sequence**:\n1. `AIRTABLE_LIST_COMMENTS` - List comments on a record [Required]\n\n**Key parameters**:\n- `baseId`: Base ID\n- `tableIdOrName`: Table identifier\n- `recordId`: Record ID (17 chars, starts with 'rec')\n- `pageSize`: Comments per page (max 100)\n\n**Pitfalls**:\n- Record IDs must be exactly 17 characters starting with 'rec'\n\n## Common Patterns\n\n### Airtable Formula Syntax\n\n**Comparison**:\n- `{Status}='Done'` - Equals\n- `{Priority}>1` - Greater than\n- `{Name}!=''` - Not empty\n\n**Functions**:\n- `AND({A}='x', {B}='y')` - Both conditions\n- `OR({A}='x', {A}='y')` - Either condition\n- `FIND('test', {Name})>0` - Contains text\n- `IS_BEFORE({Due Date}, TODAY())` - Date comparison\n\n**Escape rules**:\n- Single quotes in values: double them (`{Name}='John''s Company'`)\n\n### Pagination\n\n- Set `pageSize` (max 100)\n- Check response for `offset` string\n- Pass `offset` to next request unchanged\n- Keep filters/sorts/view stable between pages\n\n## Known Pitfalls\n\n**ID Formats**:\n- Base IDs: `appXXXXXXXXXXXXXX` (17 chars)\n- Table IDs: `tblXXXXXXXXXXXXXX` (17 chars)\n- Record IDs: `recXXXXXXXXXXXXXX` (17 chars)\n- Field IDs: `fldXXXXXXXXXXXXXX` (17 chars)\n\n**Batch Limits**:\n- CREATE_RECORDS: max 10 per request\n- UPDATE_MULTIPLE_RECORDS: max 10 per request\n- DELETE_MULTIPLE_RECORDS: max 10 per request\n\n## Quick Reference\n\n| Task | Tool Slug | Key Params |\n|------|-----------|------------|\n| List bases | AIRTABLE_LIST_BASES | (none) |\n| Get schema | AIRTABLE_GET_BASE_SCHEMA | baseId |\n| List records | AIRTABLE_LIST_RECORDS | baseId, tableIdOrName |\n| Get record | AIRTABLE_GET_RECORD | baseId, tableIdOrName, recordId |\n| Create record | AIRTABLE_CREATE_RECORD | baseId, tableIdOrName, fields |\n| Create records | AIRTABLE_CREATE_RECORDS | baseId, tableIdOrName, records |\n| Update record | AIRTABLE_UPDATE_RECORD | baseId, tableIdOrName, recordId, fields |\n| Update records | AIRTABLE_UPDATE_MULTIPLE_RECORDS | baseId, tableIdOrName, records |\n| Delete record | AIRTABLE_DELETE_RECORD | baseId, tableIdOrName, recordId |\n| Create field | AIRTABLE_CREATE_FIELD | baseId, tableIdOrName, name, type |\n| Update field | AIRTABLE_UPDATE_FIELD | baseId, tableIdOrName, fieldId |\n| Update table | AIRTABLE_UPDATE_TABLE | baseId, tableIdOrName, name |\n| List comments | AIRTABLE_LIST_COMMENTS | baseId, tableIdOrName, recordId |\n\n---\n*Powered by [Composio](https://composio.dev)*","author":"@davepoon","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/davepoon/buildwithclaude/tree/main/plugins/all-skills/skills/airtable-automation","license":"MIT","category":"storage-docs","lang":"en","tokens":1697,"stars":0,"calls30d":2,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[],"requires":{"mcp":["rube"],"tools":[]},"safety":{"flags":[],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":["composio.dev","rube.app"]}}