airtable-connect

Airtable Connect

Meta-skill for complete Airtable workspace integration.

Purpose

Enable natural language interaction with ANY Airtable base. User says "query my Projects base" or "add a record to CRM" and it just works - no manual API calls, no remembering base IDs, no schema lookups.

---

Shared Resources

This skill uses airtable-master shared library. Load references as needed:

Resource	When to Load
airtable-master/scripts/check_airtable_config.py	Always first (pre-flight)
airtable-master/references/setup-guide.md	If config check fails
airtable-master/references/error-handling.md	On any API errors
airtable-master/references/api-reference.md	For API details
airtable-master/references/field-types.md	For field type options

---

Multi-Token Support

Use --token NAME to switch between different Airtable workspaces/accounts:

# Default token (AIRTABLE_API_KEY)
uv run python discover_bases.py

# Named token (AIRTABLE_API_KEY_MUTAGENT)
uv run python discover_bases.py --token MUTAGENT

Setup multiple tokens in .env:

AIRTABLE_API_KEY=pat.xxx...          # Default token
AIRTABLE_API_KEY_MUTAGENT=pat.yyy... # Named token for Mutagent workspace
AIRTABLE_API_KEY_CLIENT=pat.zzz...   # Named token for client workspace

All scripts support --token:

• discover_bases.py --token NAME
• query_records.py --token NAME
• manage_records.py --token NAME
• manage_tables.py --token NAME
• manage_fields.py --token NAME

---

First-Time User Setup

If user has never used Airtable integration before:

1. Run config check with JSON to detect setup state:

   uv run python 00-system/skills/airtable/airtable-master/scripts/check_airtable_config.py --json
   

2. Parse the ai_action field in JSON output:

   • prompt_for_api_key → Guide user to get PAT, add to .env
   • run_setup_wizard → Run interactive wizard
   • proceed_with_warning → Partial config, warn but continue
   • proceed_with_operation → All good, continue