Codibly Airtable MCP Server

Enterprise MCP server by Codibly for seamless Airtable database integration - manage records, automate workflows, and sync data with AI assistance

View on GitHub Quick Start →

⚡ Quick Install with Claude Code MCP Guide

Connect Claude Code to any remote MCP server with one simple command. Choose between direct HTTP connections or a universal bridge - all configured automatically with our setup wizard.

Get the Claude Code MCP Setup Guide →

🔌 Test MCP Server Connection

Test your connection to the MCP wrapper server using your x-api-key. This validates that your MCP server credentials are configured correctly.

MCP Server API Key (x-api-key)

🚀 Test Full Airtable Connection

Test both your MCP server connection AND your Airtable API credentials. This ensures your complete setup is working correctly.

MCP Server API Key (x-api-key)

Airtable API Key (x-airtable-api-key)

Airtable Base ID (x-airtable-base-id) - Optional

📡 API Endpoint & Required Headers

POST https://codibly-airtable.mcp.majewscy.tech

Required HTTP Headers:

Content-Type: application/json

x-api-key: Your MCP server API key

x-airtable-api-key: Your Airtable API key (required - from airtable.com/account)

x-airtable-base-id: Your Airtable Base ID (optional - can be provided per request)

🛠️ Available Tools

list_bases

List all accessible Airtable bases

get_base_schema

Retrieve schema information for a base

list_records

List records from a table with filtering

create_record

Create new records in a table

update_record

Update existing records

delete_record

Delete records from a table

bulk_operations

Perform bulk create/update/delete operations

search_records

Search records with complex queries

⚠️ Common Errors & Solutions

401 Unauthorized

Invalid API credentials

Solution: Check your x-api-key and x-airtable-api-key are correct

403 Forbidden

Insufficient permissions

Solution: Ensure your Airtable API key has the required permissions

429 Rate Limited

Too many requests

Solution: Reduce request frequency or upgrade your Airtable plan

Actor Not Found

Specified actor does not exist

Solution: Verify the actor ID or name is correct

🏥 Service Health Check

Checking...

Response Time

Server Status

Protocol Version

2024-11-05

Last Checked

Configuration

// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "@airtable-mcp/airtable-mcp@latest"
      ],
      "env": {
        "AIRTABLE_API_KEY": "YOUR_AIRTABLE_API_KEY",
        "AIRTABLE_BASE_ID": "YOUR_BASE_ID"
      }
    }
  }
}

// HTTP Wrapper Configuration (for remote access)
{
  "airtable": {
    "type": "http",
    "url": "https://codibly-airtable.mcp.majewscy.tech",
    "headers": {
      "x-api-key": "YOUR_MCP_API_KEY",
      "x-airtable-api-key": "YOUR_AIRTABLE_API_KEY",
      "x-airtable-base-id": "YOUR_BASE_ID"
    }
  }
}

// Claude Code: .mcp.json in your project root
{
  "airtable": {
    "command": "npx",
    "args": [
      "-y",
      "@airtable-mcp/airtable-mcp@latest"
    ],
    "env": {
      "AIRTABLE_API_KEY": "YOUR_AIRTABLE_API_KEY",
      "AIRTABLE_BASE_ID": "YOUR_BASE_ID"
    }
  }
}

Features

Enterprise-grade database integration for AI assistants

📋

Database Management

Full CRUD operations on Airtable bases and tables.

🔄

Real-time Sync

Keep data synchronized between AI apps and Airtable.

🎯

Advanced Filtering

Complex queries with formula-based filtering.

📦

Bulk Operations

Efficiently handle large-scale data operations.

🔗

Linked Records

Manage relationships between tables seamlessly.

🎨

Rich Field Types

Support for attachments, checkboxes, dates, and more.

📋 Recent Updates from GitHub

v1.6.1 Aug 26, 2025

Major Update: Updated to MCP SDK 1.17.4 for latest protocol support
Enhancement: Enhanced credential validation with proper Base ID verification
Feature: Added AWS MCP-style update mechanism with real-time status monitoring
Fix: Improved error handling and user-friendly error messages
Feature: Added production-ready volume mounting for easy updates

Recent Aug 8, 2025

Fix: Improved beta release CI/CD pipeline
Update: Updated DXT descriptions for clarity

Recent Aug 7, 2025

Fix: Changed log message format for actor-mcp

Recent Aug 6, 2025

Feature: Updated DXT file structure
Fix: Resolved issue with adding non-existent Actors
Feature: Changed logs to structured format for better debugging

Recent Aug 5, 2025

Improvement: Changed info logs to debug level for cleaner output

Recent Aug 1, 2025

Feature: Added tools dump functionality

View all commits on GitHub →

🔐 Update Server