robweidner-airtable

Airtable Skills for Claude Code

Turn Claude into an Airtable expert — schema design, scripting, automations, interfaces, and API integrations.

What's Included

Skill	How to Use	What It Does
airtable	Auto-invokes when you mention Airtable	Full Airtable assistant — schema, scripts, automations, interfaces, API
airtable-extensions	/airtable:airtable-extensions	Custom React extensions — Blocks SDK + Interface Extensions SDK, dev server troubleshooting, auto-release hooks
airtable-field-audit	/airtable:airtable-field-audit	Find and fix field naming issues — duplicates, whitespace, similar names
airtable-base-audit	/airtable:airtable-base-audit	Comprehensive base health analysis — field usage, performance, schema quality

How invocation works: The main airtable skill activates automatically whenever you ask Claude about Airtable. The other three skills are slash commands you type manually. All slash commands are prefixed with airtable: because Claude Code namespaces plugin skills.

Prerequisites

Before installing, make sure you have:

• Claude Code installed and authenticated (setup guide)
• Claude Code v1.0.33+ — run claude --version to check. If below 1.0.33, update first.
• Node.js 18+ — required for the Airtable MCP server (npx airtable-mcp-server)
• An Airtable account with a Team, Business, or Enterprise plan (for extension development; schema/scripting works on any plan)

Quick Start

Step 1: Install the Plugin

From a marketplace (recommended):

# In Claude Code, run these commands:
/plugin marketplace add robweidner/airtable-skills
/plugin install airtable@robweidner-airtable

The first command registers the marketplace. The second installs the plugin. You only need to do this once.

For development/testing (load without installing):

# Clone the repo anywhere
git clone https://github.com/robweidner/airtable-skills.git

# Start Claude Code with the plugin loaded directly
claude --plugin-dir ./airtable-skills/plugins/airtable

Step 2: Create Your Airtable Token

The plugin uses the Airtable MCP server, which needs a Personal Access Token (PAT) to talk to your bases.

1. Go to airtable.com/create/tokens
2. Click Create new token
3. Name it something like "Claude Code"
4. Scopes — add these four:
   • data.records:read
   • data.records:write
   • schema.bases:read
   • schema.bases:write
5. Access — select only the base(s) you're working with (don't grant access to all bases)
6. Click Create token and copy it

Step 3: Set the Token as an Environment Variable

Add this line to your shell profile (~/.zshrc, ~/.bashrc, or ~/.bash_profile):

export AIRTABLE_PAT="patXXXXXXXXXXXXXX"

Then reload your shell:

source ~/.zshrc  # or ~/.bashrc

Why an environment variable? The plugin's .mcp.json auto-configures the Airtable MCP server and reads AIRTABLE_PAT from your environment. No manual MCP setup needed.

Step 4: Verify It Works

Start (or restart) Claude Code and try:

I have an Airtable base for tracking customer orders. Help me add a Status field with options: Pending, In Progress, Shipped, Delivered.

Claude should activate the Airtable skill automatically and guide you through it. You'll know it's working when Claude references Airtable-specific patterns like field types, API operations, or the MCP tools.

To verify the slash commands work:

/airtable:airtable-field-audit

This should start the field audit workflow.

Step 5: Save Your Preferences (Optional)

The skill adapts to your experience level. Add these to your CLAUDE.md (either ~/.claude/CLAUDE.md for global, or .claude/CLAUDE.md in your project):

## Airtable Preferences
airtable_experience: developer
airtable_emoji_mode: auto
airtable_script_style: minimal
airtable_use_field_ids: true

Preference	Options	Description
Experience	beginner / power-user / developer	Controls explanation depth
Emoji Mode	auto / new-only / ask / none	Field name emoji prefixes
Script Style	minimal / comprehensive	Output data vs. all-in-one scripts
Field IDs	true / false	Store IDs in descriptions for robust scripts

Capabilities

What You Can Do