Can I use Airtable as a CLI?

Yes. KosmoKrator exposes a Airtable CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Airtable through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Airtable tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Airtable credentials stored?

Airtable credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Airtable MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Airtable CLI for AI Agents

Use the Airtable CLI from KosmoKrator to call Airtable tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 6 read 1 write Manual OAuth token auth

Submit Airtable feedback View package source

Airtable CLI Setup

Airtable can be configured headlessly with `kosmokrator integrations:configure airtable`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure airtable --set access_token="$AIRTABLE_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor airtable --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`AIRTABLE_ACCESS_TOKEN`	Secret `secret`	yes	Access Token

Call Airtable Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call airtable.airtable_list_bases '{}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:airtable airtable_list_bases '{}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs airtable --json
kosmo integrations:docs airtable.airtable_list_bases --json
kosmo integrations:schema airtable.airtable_list_bases --json
kosmo integrations:search "Airtable" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Airtable.

`airtable.airtable_list_bases`

Read read

List all Airtable bases the token has access to.

Parameters: none

Generic CLI call

kosmo integrations:call airtable.airtable_list_bases '{}' --json

Provider shortcut

kosmo integrations:airtable airtable_list_bases '{}' --json

`airtable.airtable_get_base`

Read read

Get details for a single Airtable base by ID.

Parameters: base_id

Generic CLI call

kosmo integrations:call airtable.airtable_get_base '{"base_id":"example_base_id"}' --json

Provider shortcut

kosmo integrations:airtable airtable_get_base '{"base_id":"example_base_id"}' --json

`airtable.airtable_list_records`

Read read

List records from an Airtable table with optional filtering, sorting, and pagination.

Parameters: base_id, table, view, filter_by_formula, max_records, offset, fields, sort

Generic CLI call

kosmo integrations:call airtable.airtable_list_records '{"base_id":"example_base_id","table":"example_table","view":"example_view","filter_by_formula":"example_filter_by_formula","max_records":1,"offset":"example_offset","fields":"example_fields","sort":"example_sort"}' --json

Provider shortcut

kosmo integrations:airtable airtable_list_records '{"base_id":"example_base_id","table":"example_table","view":"example_view","filter_by_formula":"example_filter_by_formula","max_records":1,"offset":"example_offset","fields":"example_fields","sort":"example_sort"}' --json

`airtable.airtable_get_record`

Read read

Get a single Airtable record by ID.

Parameters: base_id, table, record_id

Generic CLI call

kosmo integrations:call airtable.airtable_get_record '{"base_id":"example_base_id","table":"example_table","record_id":"example_record_id"}' --json

Provider shortcut

kosmo integrations:airtable airtable_get_record '{"base_id":"example_base_id","table":"example_table","record_id":"example_record_id"}' --json

`airtable.airtable_create_record`

Write write

Create a new record in an Airtable table.

Parameters: base_id, table, fields

Generic CLI call

kosmo integrations:call airtable.airtable_create_record '{"base_id":"example_base_id","table":"example_table","fields":"example_fields"}' --json

Provider shortcut

kosmo integrations:airtable airtable_create_record '{"base_id":"example_base_id","table":"example_table","fields":"example_fields"}' --json

`airtable.airtable_list_views`

Read read

List views for an Airtable base.

Parameters: base_id

Generic CLI call

kosmo integrations:call airtable.airtable_list_views '{"base_id":"example_base_id"}' --json

Provider shortcut

kosmo integrations:airtable airtable_list_views '{"base_id":"example_base_id"}' --json

`airtable.airtable_get_current_user`

Read read

Get the profile of the currently authenticated Airtable user. Useful for verifying credentials and displaying account information.

Parameters: none

Generic CLI call

kosmo integrations:call airtable.airtable_get_current_user '{}' --json

Provider shortcut

kosmo integrations:airtable airtable_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`airtable.airtable_list_bases`

List all Airtable bases the token has access to.

Operation: Read read
Schema command: kosmo integrations:schema airtable.airtable_list_bases --json

Parameter	Type	Required	Description
No parameters.

`airtable.airtable_get_base`

Get details for a single Airtable base by ID.

Operation: Read read
Schema command: kosmo integrations:schema airtable.airtable_get_base --json

Parameter	Type	Required	Description
`base_id`	string	yes	Airtable base ID (e.g., "appXXXXXXXXXXXX").

`airtable.airtable_list_records`

List records from an Airtable table with optional filtering, sorting, and pagination.

Operation: Read read
Schema command: kosmo integrations:schema airtable.airtable_list_records --json

Parameter	Type	Required	Description
`base_id`	string	yes	Airtable base ID (e.g., "appXXXXXXXXXXXX").
`table`	string	yes	Table ID or name.
`view`	string	no	View name or ID to filter records by the view's filters.
`filter_by_formula`	string	no	Airtable formula expression to filter records (e.g., "{Status} = 'Done'").
`max_records`	integer	no	Maximum number of records to return.
`offset`	string	no	Pagination offset from a previous response.
`fields`	string	no	Comma-separated list of field names to return.
`sort`	string	no	JSON array of sort objects, e.g. [{"field":"Name","direction":"asc"}].

`airtable.airtable_get_record`

Get a single Airtable record by ID.

Operation: Read read
Schema command: kosmo integrations:schema airtable.airtable_get_record --json

Parameter	Type	Required	Description
`base_id`	string	yes	Airtable base ID (e.g., "appXXXXXXXXXXXX").
`table`	string	yes	Table ID or name.
`record_id`	string	yes	Record ID (e.g., "recXXXXXXXXXXXX").

`airtable.airtable_create_record`

Create a new record in an Airtable table.

Operation: Write write
Schema command: kosmo integrations:schema airtable.airtable_create_record --json

Parameter	Type	Required	Description
`base_id`	string	yes	Airtable base ID (e.g., "appXXXXXXXXXXXX").
`table`	string	yes	Table ID or name.
`fields`	string	yes	JSON object of field name → value pairs (e.g., {"Name":"John","Age":30}).

`airtable.airtable_list_views`

List views for an Airtable base.

Operation: Read read
Schema command: kosmo integrations:schema airtable.airtable_list_views --json

Parameter	Type	Required	Description
`base_id`	string	yes	Airtable base ID (e.g., "appXXXXXXXXXXXX").

`airtable.airtable_get_current_user`

Get the profile of the currently authenticated Airtable user. Useful for verifying credentials and displaying account information.

Operation: Read read
Schema command: kosmo integrations:schema airtable.airtable_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.