felores/airtable-mcp

A Model Context Protocol server that provides tools for interacting with Airtable's API. This server enables programmatic management of Airtable bases, tables, fields, and records through Claude Desktop or other MCP clients.
This MCP server features a specialized implementation that allows it to build tables in stages, leveraging Claude's agentic capabilities and minimizing the failure rate typically seen in other MCP servers for Airtable when building complex tables. It also includes system prompt and project knowledge markdown files to provide additional guidance for the LLM when leveraging projects in Claude Desktop.
Requirements: Node.js
1. Install Node.js (version 18 or higher) and npm from nodejs.org
2. Verify installation:
⚠️ **Important**: Before running, make sure to setup your Airtable API key
Obtaining an Airtable API Key
1. Log in to your Airtable account at airtable.com
2. Create a personal access token at Airtable's Builder Hub
3. In the Personal access token section select these scopes:
- data.records:read
- data.records:write
- schema.bases:read
- schema.bases:write
4. Select the workspace or bases you want to give access to the personal access token
5. Keep this key secure - you'll need it for configuration
Installation
Method 1: Using npx (Recommended)
1. Navigate to the Claude configuration directory:
- Windows: C:\Users\NAME\AppData\Roaming\Claude
- macOS: ~/Library/Application Support/Claude/
You can also find these directories inside the Claude Desktop app: Claude Desktop > Settings > Developer > Edit Config
2. Create or edit claude_desktop_config.json:
Note: For Windows paths, use double backslashes (\\) or forward slashes (/).
Method 2: Using mcp-installer:
mcp-installer is a MCP server to install other MCP servers.
1. Install mcp-installer
2. Install the Airtable MCP server by prompting Claude Desktop:
Claude will install the server, modify the configuration file and set the environment variable AIRTABLE_API_KEY to your Airtable API key.
Method 3: Local Development Installation
If you want to contribute or modify the code run this in your terminal:
Then modify the Claude Desktop configuration file to use the local installation:
Verifying Installation
1. Start Claude Desktop
2. The Airtable MCP server should be listed in the "Connected MCP Servers" section
3. Test with a simple command:
Features
Available Operations
Base Management
- list_bases: List all accessible Airtable bases
- list_tables: List all tables in a base
- create_table: Create a new table with fields
- update_table: Update a table's name or description
Field Management
- create_field: Add a new field to a table
- update_field: Modify an existing field
Record Operations
- list_records: Retrieve records from a table
- create_record: Add a new record
- update_record: Modify an existing record
- delete_record: Remove a record
- search_records: Find records matching criteria
- get_record: Get a single record by its ID
Field Types
- singleLineText: Single line text field