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

# Set up Airtable MCP Server

> Register an Airtable OAuth integration and connect Airtable's MCP server to TrueFoundry.

Airtable's MCP server at `https://mcp.airtable.com` can read and write records, manage base schemas, read comments, browse workspaces, and manage webhooks. Register an Airtable OAuth integration and connect it through TrueFoundry.

## Prerequisites

* A TrueFoundry account with permission to add MCP servers.
* Airtable permission to create OAuth integrations.

## Register an Airtable OAuth Integration

Go to [airtable.com/create/oauth](https://airtable.com/create/oauth), create a new OAuth integration, and set the redirect URL to:

```txt theme={"dark"}
https://<tfy-control-plane-base-url>/api/svc/v1/llm-gateway/mcp-servers/oauth2/callback
```

Add only the scopes your agents need:

| Scope                       | Capability                |
| --------------------------- | ------------------------- |
| `data.records:read`         | Read records              |
| `data.records:write`        | Create and update records |
| `schema.bases:read`         | Read base schemas         |
| `schema.bases:write`        | Modify schemas            |
| `data.recordComments:read`  | Read comments             |
| `data.recordComments:write` | Write comments            |
| `workspacesAndBases:read`   | List workspaces and bases |
| `webhook:manage`            | Manage webhooks           |

Copy the Client ID and Client Secret.

## Register in TrueFoundry

Add a remote MCP server with:

| Field                  | Value                                  |
| ---------------------- | -------------------------------------- |
| **Name**               | `airtable`                             |
| **URL**                | `https://mcp.airtable.com`             |
| **Authentication**     | `OAuth2`                               |
| **Grant Type**         | `Authorization Code`                   |
| **Client ID / Secret** | Airtable OAuth integration credentials |

Add collaborators and save the server. Users should open the server's **Tools** section and click **Connect Now**; after OAuth succeeds, Airtable tools appear and can be tried from the **Agent Playground**.

## Security Notes

Users choose which bases the integration can access during Airtable OAuth. Remove `schema.bases:write`, `data.records:write`, or `webhook:manage` if agents should not mutate Airtable.