Airtable list records

airtable__list_records

Access

Requires a project integration connection for airtable.

Call type: Can read or manage credentials.

Arguments

FieldTypeRequiredDescription and constraints
baseIdstringYesAirtable base ID
tableIdOrNamestringYesTable ID or URL-encoded table name
viewstringNoOptional view name or ID
filterByFormulastringNoAirtable formula used to filter returned records
maxRecordsnumberNoMaximum records to return
pageSizenumberNoRecords per page
offsetstringNoPagination offset from Airtable

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "airtable__list_records",
    "arguments": {
      "baseId": "example",
      "tableIdOrName": "example"
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the airtable integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "baseId": {
      "type": "string",
      "description": "Airtable base ID"
    },
    "tableIdOrName": {
      "type": "string",
      "description": "Table ID or URL-encoded table name"
    },
    "view": {
      "type": "string",
      "description": "Optional view name or ID"
    },
    "filterByFormula": {
      "type": "string",
      "description": "Airtable formula used to filter returned records"
    },
    "maxRecords": {
      "type": "number",
      "description": "Maximum records to return"
    },
    "pageSize": {
      "type": "number",
      "description": "Records per page"
    },
    "offset": {
      "type": "string",
      "description": "Pagination offset from Airtable"
    }
  },
  "required": [
    "baseId",
    "tableIdOrName"
  ],
  "description": "Arguments for the airtable__list_records tool."
}