> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Airtable Agent Connector

> Connect your Agent to Airtable to read and write records from your bases and tables.

The Airtable Connector gives your [Agents](https://docs.cassidyai.com/agents/overview.md) both read and write access to your Airtable bases and tables. Agents can query records, create new entries, and update existing ones directly during conversations — with granular permission controls so you decide what the Agent can do. Data is accessed in real time and never copied or stored in Cassidy.

> [!TIP]
>
> For best results with complex Connector queries, use a powerful,
> reasoning-capable model. Cassidy supports models from OpenAI, Anthropic,
> Google, and Open Source — see [Choose the right AI
> model](https://docs.cassidyai.com/guides/choose-ai-model.md) for current recommendations.

## Set up the Airtable Connector

**1. Navigate to your Agent**

Go to **Agents** and select the Agent you want to configure.

![Agents page with list of available Agents](https://mintcdn.com/cassidy/mzDBRDD-FW3Bbqp4/images/integrations/airtable-tool-img-0.png?fit=max\&auto=format\&n=mzDBRDD-FW3Bbqp4\&q=85\&s=f079f985824bd04bab958c295528f79f)

**2. Open the Connectors section**

Click the **Setup** tab and scroll to the **Connectors** section.

![Agent Setup tab showing the Connectors section](https://mintcdn.com/cassidy/mzDBRDD-FW3Bbqp4/images/integrations/airtable-tool-img-1.png?fit=max\&auto=format\&n=mzDBRDD-FW3Bbqp4\&q=85\&s=41d16e71f03e234bc733bb07970aa85e)

**3. Add the Airtable Connector**

Click **+ Add Connector** and select **Airtable**.

![Connector picker with Airtable option](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-2.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=388467b9e350fe0c53e31dae08508d67)

**4. Choose a connection method**

Select how users will authenticate:

* **Each user connects their own account** (recommended) — each user signs in with their own Airtable credentials
* **Use a shared connection** — all users access Airtable through one shared account

![Connection method selection for Airtable](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-3.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=b6308d9558c8edc353de3c57767ccd7e)

**5. Set up the connection**

If using a shared connection, click **Set up shared connection** and sign in to Airtable. Before granting access, you'll need to click either **Add all resources** to grant access to all your bases, or **Add a base** to select only the specific bases you want the Agent to access.

![Shared connection setup for Airtable](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-4.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=d0df247849f52cd3abe8903599a714c3)

![Airtable authorization and base selection](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-5.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=095ef7521a42b7f51db72ea13fef2719)

Give a new shared connection a recognizable name, then choose the people
and groups who can use it.

> [!WARNING]
>
> Everyone with access acts through the same Airtable account. Use a
> dedicated service account when possible.

**6. Configure action permissions**

Set permissions for each action the Agent can perform:

* **Always allow** — The Agent performs the action automatically when needed
* **Ask every time** — The Agent asks the user before taking the action
* **Disabled** — The Agent cannot perform the action

You decide the permission level for each action separately. For example,
you might set **Search records** to **Always allow** but **Delete records**
to **Disabled**.

> [!WARNING]
>
> Airtable is a read/write Connector. Review permissions carefully — **Always allow** lets the Agent create or modify records without asking first.

**7. Enable the Connector**

Click **Add** to enable the Connector for this Agent.

![Add button to enable the Airtable Connector](https://mintcdn.com/cassidy/mzDBRDD-FW3Bbqp4/images/integrations/airtable-tool-img-11.png?fit=max\&auto=format\&n=mzDBRDD-FW3Bbqp4\&q=85\&s=372b05af2d878314edccd1a36d5b6334)

**8. Start a conversation**

Navigate to **Chat** and select the Agent with the Airtable Connector enabled.

If you chose **Each user connects their own account**, users are prompted to connect their Airtable account from within the chat the first time they use the Connector.

Once connected, your Agent can access Airtable data to answer questions about records, projects, campaigns, and other information stored in your bases — as well as create and update entries.

![Chat with the Airtable-enabled Agent showing connection prompt](https://mintcdn.com/cassidy/mzDBRDD-FW3Bbqp4/images/integrations/airtable-tool-img-12.png?fit=max\&auto=format\&n=mzDBRDD-FW3Bbqp4\&q=85\&s=829ff409cb231032b1f9774fccf50f91)

![Agent responding with Airtable data in the conversation](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-13.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=c680258dc03244ef5316ef5c00f87145)

## Connect Airtable for yourself

To use Airtable in any chat, not just with this Agent, open **Customize** →
**Connectors**, find **Airtable**, and click **Connect**. See [Add a Connector for
yourself](https://docs.cassidyai.com/agents/connectors/overview.md#add-a-connector-for-yourself).

## Monitor Airtable actions

When an Agent uses the Airtable Connector, expand the action in the response to see its input, result, and approval status.

![Expanded Airtable action in a chat response showing what the Agent did](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-14.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=b931b9d986cc7d8ae85458b6114d7f54)

![Expanded Airtable action details showing the query and results](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-15.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=8c7a771ae0c3fc220d65e389cbb5f7fa)

If an action lacks the required permissions, the step shows **No output data**.

![Airtable action showing No output data due to missing permissions](https://mintcdn.com/cassidy/qKWfjzQ47rz14Mj6/images/integrations/airtable-tool-img-16.png?fit=max\&auto=format\&n=qKWfjzQ47rz14Mj6\&q=85\&s=a3c6042e8895c434506f4ae64102d5f2)

## Data security

Airtable data is accessed in real time and is not copied or stored in Cassidy. The Agent only queries Airtable when needed to answer a question or complete a task.

> [accordion] OAuth scopes
>
> The Airtable Connector requests access to read and write records in the bases
> you authorize. Cassidy does not access bases outside the ones you explicitly
> grant permission to.

## Next steps

> [card] [Connectors overview](https://docs.cassidyai.com/agents/connectors/overview.md)
>
> Learn about all available Agent Connectors and how they work.

> [card] [Browse integrations](https://docs.cassidyai.com/integrations/overview.md)
>
> See every integration available in Cassidy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.