airtable-filters

Build Airtable record filters using field IDs, operators, and nested AND/OR logic.

5.3k|765|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/openai/plugins --skill airtable-filters
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: airtable-filters
Source: https://github.com/openai/plugins/tree/main/plugins/airtable/skills/airtable-filters
Command: npx skills add https://github.com/openai/plugins --skill airtable-filters

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Constructing valid Airtable record filters requires knowing field IDs, select choice IDs, correct operators per field type, and how to compose nested AND/OR conditions, which is error-prone without a reference.

Core Features & Use Cases

  • Operator Reference: Maps comparison operators (=, contains, hasAnyOf, isWithin, and more) to the correct Airtable field type categories.
  • Field-Type Rules: Enforces choice IDs for select fields, date value objects with time zones for date fields, and fileType filters for attachments.
  • Nested Logic Composition: Guides building mixed AND/OR filter trees for complex queries like "Scripted videos that are either in Writing or Pre-Production."
  • Use Case: When a user asks to find all approved records or records assigned to a specific collaborator in a given status, this Skill produces a single composed filters object with the correct field IDs and operators.

Quick Start

Build the right Airtable filters for this query, including field IDs, select choice IDs, dates, and nested logic.

Frequently Asked Questions about airtable-filters

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

FAQPage Schema
How do I filter Airtable records by field values?

Pass a filters object to Airtable MCP tools that list records, with each condition containing an operator and an operands array whose first element is a field ID. Multiple conditions combine with AND by default, or with an explicit top-level operator like or.

How do I filter Airtable records by a single select field?

Single select filters require choice IDs such as selABCDEFGHIJKLM, not display names. Look up the table schema to find choice IDs, then use operators like =, isAnyOf, or isNoneOf with an array of choice IDs.

Can I combine AND and OR conditions in one Airtable filter?

Yes, nest a filter object as one of the operands to mix AND and OR logic. Each nested filter has its own operator and operands, enabling patterns like Bucket = Scripted AND (Status = Writing OR Status = Pre-Production).

How do I filter Airtable records by date range?

Use the isWithin operator with a date range object such as {"mode": "pastWeek", "timeZone": "America/New_York"}. Direct date comparisons use a date value object instead of a raw string, and a timeZone must always be included.

Why does my Airtable filter fail on collaborator group fields?

Filtering by a collaborator group ID matches the literal group, not its members. Set operatorOptions with matchGroupsByMembership set to true so operators like hasAnyOf match individual members of the group.