agentskit.js
ToolsIntegrations

airtable

Airtable — list and create records in any table by base id.

import { airtable } from '@agentskit/tools/integrations'

const tools = airtable({
  apiKey: process.env.AIRTABLE_TOKEN!,
  baseId: 'app1234567890ABCD',
})

Bundled: airtable(config) returns both sub-tools. Calls Airtable REST API v0 scoped to the configured baseId.

#Sub-tools

NamePurpose
airtable_list_recordsList records from a table, with optional formula filter
airtable_create_recordCreate a record in a table

#Schema

#airtable_list_records

ParameterTypeRequiredDescription
tablestringyesTable name or ID
filterByFormulastringnoAirtable formula to filter records, e.g. {Status}="Open"
pageSizenumbernoRecords per page (default 50)

Returns: array of { id, fields } plus an optional offset cursor.

#airtable_create_record

ParameterTypeRequiredDescription
tablestringyesTable name or ID
fieldsobjectyesField name → value map matching the table schema

#Example — content pipeline agent

import { createRuntime } from '@agentskit/runtime'
import { airtable } from '@agentskit/tools/integrations'

const runtime = createRuntime({
  adapter,
  systemPrompt: 'You manage a content calendar. List pending items and create new entries when asked.',
  tools: airtable({
    apiKey: process.env.AIRTABLE_TOKEN!,
    baseId: process.env.AIRTABLE_BASE_ID!,
  }),
})

await runtime.run('List all records in "Content Calendar" where Status is Pending.')

#Security

  • Env vars required: AIRTABLE_TOKEN (personal access token from airtable.com/create/tokens) and AIRTABLE_BASE_ID (the base ID from the Airtable URL: airtable.com/<baseId>/...).
  • Scopes required: data.records:read, data.records:write. Restrict to only the bases the agent needs via the token's base-level permissions.
  • Airtable enforces 5 requests/second per token by default; add retry logic for high-volume agents.
  • The filterByFormula parameter is passed directly to Airtable — treat it as untrusted input if constructed from user messages.

Explore nearby

✎ Edit this page on GitHub·Found a problem? Open an issue →·How to contribute →

On this page

Ask the docs

Ask anything about AgentsKit. Answers come from the docs corpus via OpenRouter free-tier models. Rate limited per IP.