airtable-connect

Connects to Airtable bases to query, create, update, and delete records via natural language.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill airtable-connect-fahadimdad
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: airtable-connect
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/airtable/airtable-connect
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill airtable-connect-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with Airtable normally requires manual API calls, remembering base IDs, and looking up table schemas. This Skill removes that friction by letting you query, add, update, and delete records in any Airtable base using plain language, with automatic base discovery and schema caching. ## Core Features & Use Cases - Workspace Discovery & Schema Caching: Automatically finds all accessible Airtable bases and caches their table schemas to a local context file for fast fuzzy name matching. - Full Record Operations: Query records with filters, create records with schema-validated fields, update existing records, delete records, and run batch operations (up to 10 records per request). - Guided Setup & Error Handling: Pre-flight configuration checks detect missing API tokens, guide PAT setup with correct scopes, and provide recovery steps for permission and rate-limit errors. - Use Case: Say "query my Projects base for active items" and the Skill matches the base by fuzzy name, runs the query with your filter, and displays formatted results using the cached schema. ## Quick Start Say "connect airtable" to discover your bases, then ask to query or add records to any base by name.

Frequently Asked Questions about airtable-connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Airtable to Claude or an AI assistant?

Create a Personal Access Token at airtable.com/create/tokens with data.records:read, data.records:write, and schema.bases:read scopes, then add it to your .env file. The config check script verifies the token and discovers your accessible bases automatically.

How do I query Airtable records by base name instead of base ID?

Run the discovery script first to cache base names, IDs, and table schemas into a YAML context file. Queries then use fuzzy matching on base names, so saying "Projects" can match "Client Projects" without needing the app ID.

What Airtable API token scopes are needed for read and write access?

You need three scopes: data.records:read for queries, data.records:write for creating and updating records, and schema.bases:read for discovering bases and caching table schemas. Missing scopes cause permission-denied errors during operations.

Why does Airtable discovery show no bases after connecting?

This happens when the Personal Access Token has no bases assigned to it. Edit the token at airtable.com/create/tokens and grant it access to specific bases or your entire workspace, then re-run the discovery script.

What is the batch operation limit in the Airtable API?

Airtable limits batch create, update, and delete operations to 10 records per request. Larger datasets must be split into multiple sequential batch calls, and rate limiting (HTTP 429) requires retrying with exponential backoff.