How to integrate Airtable MCP with Atomic Agent

Connect Atomic Agent to Airtable MCP. Add new contacts from a signup list, create a project tracking table in workspace, and more using natural language, with authentication handled for you.

Airtable logoAirtable
Oauth2Api Key

Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.

23 Tools6 Triggers

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Airtable.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Airtable account. See the Atomic Agent documentation for installation instructions.

Also integrate Airtable with

How Atomic Agent connects to Airtable

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Airtable to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Airtable. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Airtable account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Airtable MCP server, and what's possible with it?

The Airtable MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Airtable account. It provides structured and secure access to your Airtable bases and tables, so your agent can create records, update fields, manage tables, retrieve schemas, and automate project tracking on your behalf.

  • Seamless record creation and management: Easily instruct your agent to add new records, create multiple entries at once, or delete outdated information across any Airtable table.
  • Intuitive table and field customization: Ask your agent to design new tables, add or modify fields, and tailor the structure of your bases for evolving projects and workflows.
  • Efficient schema discovery: Let your agent fetch detailed schema information, including fields and configurations, to power data-driven automation and analysis.
  • Collaborative commenting: Have your agent add or remove comments on specific records, making team collaboration and discussion much smoother from anywhere.
  • Bulk operations for productivity: Enable your agent to perform batch actions like creating or deleting multiple records in one go, saving you time on repetitive data management tasks.

Use Airtable from Atomic Agent

With your account connected, ask Atomic Agent to work with Airtable in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS & TRIGGERS

Supported Tools and Triggers

Every Airtable action and event your agent gets out of the box.

Create base

Creates a new Airtable base with specified tables and fields within a workspace.

Create Comment

Tool to create a comment on a specific Airtable record.

Create Field

Creates a new field within a specified table in an Airtable base.

Create Record From Natural Language

Creates a new record in an Airtable table from a natural language description.

Create records

Tool to create multiple records (up to 10) in a specified Airtable table.

Create table

Creates a new table within a specified existing Airtable base, allowing definition of its name, description, and field structure.

Delete Comment

Tool to delete a comment from a record in an Airtable table.

Delete multiple records

Tool to delete up to 10 specified records from a table within an Airtable base.

Delete Record

Permanently deletes a specific record from an existing table within an existing Airtable base.

Get Base Schema

Retrieves the detailed schema for a specified Airtable base, including its tables, fields, field types, and configurations, using the `baseId`.

Get Record

Retrieves a specific record from an Airtable table by its record ID.

Get user information

Retrieves information, such as ID and permission scopes, for the currently authenticated Airtable user from the `/meta/whoami` endpoint.

List bases

Retrieves all Airtable bases accessible to the authenticated user, which may include an 'offset' for pagination.

List Comments

Tool to list comments on a specific Airtable record.

List records

Tool to list records from an Airtable table with filtering, sorting, and pagination.

Update Comment

Tool to update an existing comment on a specific Airtable record.

Update Field

Updates a field's name or description in an Airtable table.

Update multiple records

Tool to update up to 10 records in an Airtable table with selective field modifications.

Update multiple records (PUT)

Tool to destructively update multiple records in Airtable using PUT, clearing unspecified fields.

Update record

Modifies specified fields of an existing record in an Airtable base and table; the base, table, and record must exist.

Update record (PUT)

Updates an existing record in an Airtable base using PUT method.

Update Table

Updates the name, description, and/or date dependency settings of a table in Airtable.

Upload attachment

Uploads a file attachment to a specified field in an Airtable record.

FAQ

Frequently asked questions

With a standalone Airtable MCP server, the agents and LLMs can only access a fixed set of Airtable tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Airtable and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Airtable tools.

Yes, absolutely. You can configure which Airtable scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Airtable data and credentials are handled as safely as possible.

Start with Airtable.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Airtable tool your agent needs.Free to start.

Start building