Skip to main content

Set up the Airtable MCP server

Airtable publishes an official MCP server at mcp.airtable.com that lets AI agents read and write records, manage base schemas, handle record comments, browse workspaces and bases, and manage webhooks. This guide walks through registering an Airtable OAuth integration, configuring scopes, and connecting it to MintMCP as a remote MCP.

Prerequisites​

  • A MintMCP admin account
  • An Airtable account with permission to create OAuth integrations

Register an Airtable OAuth integration​

  1. Go to airtable.com/create/oauth.

  2. Click Register new OAuth integration.

  3. Fill in the integration details:

    • Name: MintMCP
    • OAuth redirect URLs: https://app.mintmcp.com/oauth/callback

  4. Click Register integration. Airtable generates a Client ID and Client Secret — you'll collect these in the next section.

  5. Add the following scopes to the integration:

ScopeWhat it enables
data.records:readRead records from tables
data.records:writeCreate and update records
schema.bases:readView base and table schemas
schema.bases:writeCreate and modify tables and fields
data.recordComments:readRead record comments
data.recordComments:writeCreate and update record comments
workspacesAndBases:readList workspaces and bases (Business and Enterprise Scale plans only)
webhook:manageCreate and manage webhooks
  1. Click Save changes.

Copy the client ID and secret​

  1. On your OAuth integration page, copy the Client ID.
  2. Click Generate client secret (or copy the existing secret if already generated). Copy the Client Secret. Store it securely — it is shown only once.

Add Airtable to MintMCP​

  1. In MintMCP, go to MCP store > Manage store.
  2. Find the Airtable MCP server and click to configure it.
  3. Open OAuth Client Advanced Settings and paste the Client ID and Client Secret from your Airtable integration.
  4. Save the configuration.

Security considerations​

  • Keep the client secret secure — anyone with it can impersonate your OAuth integration.
  • Each user authenticates individually through Airtable OAuth, so tool calls are tied to their Airtable identity and permissions.
  • The workspacesAndBases:read scope is only available on Business and Enterprise Scale Airtable plans — remove it if your plan doesn't include it.
  • Users can control which bases the integration can access from their Airtable account under Account > Apps and integrations.