# airtable-cli

This skill lets Codex inspect and change Airtable data through airtable-mcp. Use it for bases, tables, fields, records, searches, and filters.

- skill · `type=skill` · Codex, ChatGPT · ★ 7604
- Author: Airtable · official OpenAI repository
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openai/plugins/tree/HEAD/plugins/airtable/skills/airtable-cli/SKILL.md
- Updated: 2026-10-08
- HTML: https://affpapa.org/en/nevibecode/skills/airtable-cli

## What it does

\`airtable-cli` gives Codex a way to work with Airtable through the `airtable-mcp` command line interface. It can locate bases, inspect tables and records, update data, manage fields, and run text searches or structured filters.

The workflow starts by discovering the tools exposed by the MCP server with `airtable-mcp tools`. The agent can then inspect a tool’s flags through `airtable-mcp <tool> --help` before running it. Tool names and argument shapes come from the server at runtime, so they can change between releases. JSON input through stdin is available for more involved requests, and record writes use field IDs.

An Airtable personal access token (PAT) is required. Set `AIRTABLE_TOKEN` or save credentials with `airtable-mcp configure`; the token must carry the scopes needed by the selected tools. Without a token, the CLI cannot make Airtable requests.

## Install

### Codex (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill airtable-cli -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/airtable-cli/SKILL.md` — For all projects use ~/.agents/skills/

### Claude Code

1. **Skills CLI (Vercel)**
```bash
npx skills add openai/plugins --skill airtable-cli -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/airtable-cli/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/airtable-cli/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/airtable-cli/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install openai/plugins airtable-cli
```

2. **Manually: put the files in place**
- File: `.github/skills/airtable-cli/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/openai/plugins --path plugins/airtable/skills/airtable-cli
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/airtable-cli/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/openai/plugins/tree/HEAD/plugins/airtable/skills/airtable-cli/SKILL.md

## When to use it
- locate a specific Airtable base
- list tables and records from a base
- filter records by exact field values
- search large tables with free-text queries
- update several record fields with JSON input

## Example prompts
- Find the Airtable base named “Project Tracker” and list its tables.
- Read records from table `tblL4GpTfEz8byRsW`, return `Name` and `Status`, and keep rows whose status is `Done`.
- Use `update-records-for-table` to change an Airtable record, passing the request body as JSON through stdin.

## Similar
- [airtable-automation](https://affpapa.org/en/nevibecode/skills/airtable-automation.md) — skill · 6200 installs
- [airtable](https://affpapa.org/en/nevibecode/skills/membrane-airtable.md) — skill · 374 installs
- [Airtable User MCP](https://affpapa.org/en/nevibecode/mcp/airtable-user-mcp.md) — MCP server · ★ 32
- [mcp](https://affpapa.org/en/nevibecode/mcp/waystation-ai-mcp.md) — MCP server · ★ 65
- [research-repository](https://affpapa.org/en/nevibecode/skills/research-repository.md) — skill · 1700 installs
- [instaclaw](https://affpapa.org/en/nevibecode/skills/instaclaw.md) — skill · 4500 installs

From the same set: [openai/plugins](https://affpapa.org/en/nevibecode/by/openai/plugins.md) — 528 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md