Prerequisites

  • Airtable Account

Step 1: Create Airtable OAuth Integration

  1. Visit https://airtable.com/create/oauth
  2. Click “Register new OAuth Integration”
OAuth Integration Creation

Step 2: Register an Integration

  1. Enter “Name”
  2. Add redirect URLs: https://api.klavis.ai/oauth/airtable/callback
  3. Click “Register Integration”
Here is an example of Klavis AI OAuth app configuration: OAuth Settings Configuration Once registered, Airtable will generate your Client ID and Client Secret. You’ll need these for connecting Klavis AI.

Step 3: Request Scopes

Klavis Airtable MCP Server uses the following OAuth scopes: data.records:read, data.records:write, data.recordComments:read, data.recordComments:write, schema.bases:read, schema.bases:write, user.email:read
  1. After registration, add required scopes.
Product Access and Credentials
  1. Enter Required Info, Then click “Save Changes”
You have successfully created an Airtable OAuth application! You now have your Client ID and Client Secret ready for integration with Klavis AI.

(Optional) Step 4: White Labeling

White labeling allows you to customize the OAuth experience with your own branding instead of Klavis AI’s.
If you want to use your own Airtable OAuth application with custom branding:
  1. Configure White Labeling: Go to https://www.klavis.ai/home/white-label
  2. Add Your Credentials: Enter your Airtable Client ID and Client Secret from Step 3
  3. Set Redirect URI: Use https://api.klavis.ai/oauth/airtable/callback or your custom callback URL
  4. Initiate OAuth: Use your client ID when starting the OAuth flow:
    const authUrl = `https://api.klavis.ai/oauth/airtable/authorize?instance_id=${instanceId}&client_id=${yourClientId}`;
    
For detailed white labeling implementation and code examples, see our OAuth & White Labeling guide.

Resources