# Claude Code

## Use the official plugin (recommended)

The Claude Code plugin for Airtable bundles the MCP server and a collection of skills that teaches Claude what Airtable is and how data is structured.

1. Run this command in your terminal:

```
claude plugin install airtable@claude-plugins-official
```

2. Restart Claude Code:

```
claude
```

3. Inside Claude Code, open the plugin menu:

```
/plugin
```

4. In the terminal:
    - Press the right arrow key and open the `Installed` tab.
    - Find `Airtable MCP` and press **Enter** to open its MCP server details.
    - Press **Enter** on `Authenticate`.
    - Authorize via OAuth in the browser window.

OAuth Client ID:

```
https://claude.ai/oauth/claude-code-client-metadata
```

### Connecting manually - OAuth

1. Run this command in your terminal:

```
claude mcp add --transport http airtable https://mcp.airtable.com/mcp
```

Alternatively, open your Claude Code configuration file at `~/.claude.json` (or a project-scoped `.mcp.json` in trusted projects), and add the following:

```
{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "airtable": {
          "type": "http",
          "url": "https://mcp.airtable.com/mcp"
        }
      }
    }
  }
}
```

2. Restart Claude Code:

```
claude
```

3. Inside Claude Code, open the MCP server menu:

```
/mcp
```

    - Find `Airtable` and press **Enter** to open its MCP server details.
    - Press **Enter** on `Authenticate`.
    - Authorize via OAuth in the browser window.

### Connect manually - Personal Access Token (PAT)

1. [Create a personal access token](/create/tokens/new?scopes=data.records:read,data.records:write,schema.bases:read,schema.bases:write,data.recordComments:read,data.recordComments:write,workspacesAndBases:read) with the Airtable MCP scopes pre-selected (remove any you don't need to limit access).
2. Store your PAT as an environment variable (e.g., `AIRTABLE_PAT`).
3. Run this command in your terminal:

```
claude mcp add \
  --transport http airtable \
  https://mcp.airtable.com/mcp \
  --header "Authorization: Bearer ${AIRTABLE_PAT}"
```

Alternatively, open your user-level Claude Code configuration file at `~/.claude.json` (or a project-level `.mcp.json` in trusted projects), and add the following:

```
{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "airtable": {
          "type": "http",
          "url": "https://mcp.airtable.com/mcp",
          "headers": {
            "Authorization": "Bearer ${AIRTABLE_PAT}"
          }
        }
      }
    }
  }
}
```

4. Restart Claude Code:

```
claude
```

5. Inside Claude Code, open the MCP server menu:

```
/mcp
```

    - Find `airtable` and press **Enter** to open its MCP server details.
    - Confirm that its **Status** is `connected` and **Auth** is `authenticated`.
    - Do not press **Re-authenticate** as Claude Code will initiate OAuth authorization!