Airtable Skill

Unified Airtable skill for AI agents. 6 access methods with a decision tree, covering MCP, REST API, internal web API, Omni AI, scripting, formulas, webhooks, and automations. Built from real production work with 60+ Airtable bases at D1DX.

What's Included

| Topic | What it covers | |-------|---------------| | Method Decision Tree | When to use MCP vs REST API vs Internal API vs Omni AI vs Scripting | | MCP | Tool reference, detail levels, safe vs write operations | | Omni AI | Capabilities the API can't do — field configs, interfaces, automations, Field Agents | | REST API | Batch limits, upsert, webhooks (create, poll, HMAC), pagination | | Internal Web API | Reverse-engineered endpoints — Interface Designer layout, visibility filters, automation export, ID prefixes | | Scripting API | Standalone vs Automation context, batch limits (50 not 10), field value type differences | | Automations | Trigger/action types, duplicate automation prevention, latency notes | | Formulas | Text, date, regex (RE2), arrays, logic functions, filterByFormula patterns | | Field Types | REST vs Scripting JSON differences for every field type | | Gotchas | 18 hard-won lessons — attachment URL expiry, checkbox null, field rename breakage, msgpack responses |

Install

Claude Code

git clone https://github.com/D1DX/airtable-skill.git
cp -r airtable-skill ~/.claude/skills/airtable

Or as a git submodule:

git submodule add https://github.com/D1DX/airtable-skill.git path/to/skills/airtable

Other AI Agents

Copy SKILL.md (and supporting files) into your agent's prompt or knowledge directory. The skill is structured markdown — works with any LLM agent that reads reference files.

Structure

airtable-skill/
├── SKILL.md                  — Main skill (6 methods, decision tree, gotchas)
├── interface-api.md          — Full internal web API spec (Interface Designer, readQueries)
├── reference.md              — Quick reference tables
└── extract_automations.py    — Script to export automations via internal API

Recommended: Airtable MCP Server

This skill works standalone but pairs well with an Airtable MCP server for live base access. The skill provides knowledge; the MCP provides record operations.

| MCP Server | What it adds | |-----------|-------------| | domdomegg/airtable-mcp-server | Record CRUD, schema, search, comments, attachments |

Sources

• REST API & Scripting: Verified against Airtable Web API docs and production usage (60+ bases).
• Internal Web API: Reverse-engineered from browser traffic (HAR captures, March 2026). Endpoints may change without notice.
• Omni AI: Capabilities verified from official Airtable documentation (April 2026).
• Formulas: Verified against Airtable formula reference.

Credits

Built by Daniel Rudaev at D1DX.

License

MIT License — Copyright (c) 2026 Daniel Rudaev @ D1DX