airtable-mcp-server

Ein Model Context Protocol-Server, der Lese- und Schreibzugriff auf Airtable-Datenbanken ermöglicht. Dieser Server erlaubt es LLMs, Datenbankschemata zu untersuchen sowie Datensätze zu lesen und zu schreiben.

https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944

Installation

Schritt 1: Erstellen Sie ein persönliches Airtable-Zugriffstoken, indem Sie hier klicken. Details:

• Name: Beliebig, z. B. 'Airtable MCP Server Token'.

• Scopes: schema.bases:read, data.records:read und optional schema.bases:write, data.records:write, data.recordComments:read und data.recordComments:write.

• Zugriff: Die Bases, auf die Sie zugreifen möchten. Wenn Sie sich nicht sicher sind, wählen Sie 'Add all resources'.

Halten Sie das Token bereit, Sie werden es im nächsten Schritt benötigen. Es sollte in etwa so aussehen: pat123.abc123 (aber länger).

Schritt 2: Befolgen Sie die unten stehenden Anweisungen für Ihren bevorzugten Client:

• Claude Desktop

• Cursor

• Cline

Claude Desktop

(Empfohlen) Über den Erweiterungs-Browser

1. Öffnen Sie Claude Desktop und gehen Sie zu Einstellungen → Erweiterungen

2. Klicken Sie auf 'Browse Extensions' und suchen Sie nach 'Airtable MCP Server'

3. Klicken Sie auf 'Install' und fügen Sie Ihren API-Schlüssel ein

(Fortgeschritten) Alternative: Über manuelle .mcpb-Installation

1. Suchen Sie den neuesten mcpb-Build in der GitHub Actions-Historie (der oberste)

2. Laden Sie im Abschnitt 'Artifacts' die Datei airtable-mcp-server-mcpb herunter

3. Benennen Sie die .zip-Datei in .mcpb um

4. Doppelklicken Sie auf die .mcpb-Datei, um sie mit Claude Desktop zu öffnen

5. Klicken Sie auf "Install" und konfigurieren Sie sie mit Ihrem API-Schlüssel

(Fortgeschritten) Alternative: Über JSON-Konfiguration

1. Installieren Sie Node.js

2. Öffnen Sie Claude Desktop und gehen Sie zu Einstellungen → Entwickler

3. Klicken Sie auf "Edit Config", um Ihre claude_desktop_config.json-Datei zu öffnen

4. Fügen Sie die folgende Konfiguration zum Abschnitt "mcpServers" hinzu und ersetzen Sie pat123.abc123 durch Ihren API-Schlüssel:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123",
      }
    }
  }
}

5. Speichern Sie die Datei und starten Sie Claude Desktop neu

Cursor

(Empfohlen) Über Ein-Klick-Installation

1. Klicken Sie auf

2. Bearbeiten Sie Ihre mcp.json-Datei, um Ihren API-Schlüssel einzufügen

(Fortgeschritten) Alternative: Über JSON-Konfiguration

Erstellen Sie entweder eine globale (~/.cursor/mcp.json) oder eine projektspezifische (.cursor/mcp.json) Konfigurationsdatei und ersetzen Sie pat123.abc123 durch Ihren API-Schlüssel:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Cline

(Empfohlen) Über den Marketplace

1. Klicken Sie auf das "MCP Servers"-Symbol in der Cline-Erweiterung

2. Suchen Sie nach "Airtable" und klicken Sie auf "Install"

3. Folgen Sie den Anweisungen, um den Server zu installieren

(Fortgeschritten) Alternative: Über JSON-Konfiguration

1. Klicken Sie auf das "MCP Servers"-Symbol in der Cline-Erweiterung

2. Klicken Sie auf den Tab "Installed" und dann unten auf die Schaltfläche "Configure MCP Servers"

3. Fügen Sie die folgende Konfiguration zum Abschnitt "mcpServers" hinzu und ersetzen Sie pat123.abc123 durch Ihren API-Schlüssel:

{
  "mcpServers": {
    "airtable": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Related MCP server: MCP TapData Server

Komponenten

Tools

• list_records

  • Listet Datensätze aus einer angegebenen Airtable-Tabelle auf

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der abzufragenden Tabelle

    • maxRecords (number, optional): Maximale Anzahl der zurückzugebenden Datensätze. Standardwert ist 100.

    • filterByFormula (string, optional): Airtable-Formel zum Filtern von Datensätzen

• search_records

  • Sucht nach Datensätzen, die einen bestimmten Text enthalten

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der abzufragenden Tabelle

    • searchTerm (string, erforderlich): Text, nach dem in Datensätzen gesucht werden soll

    • fieldIds (array, optional): Spezifische Feld-IDs, in denen gesucht werden soll. Wenn nicht angegeben, werden alle textbasierten Felder durchsucht.

    • maxRecords (number, optional): Maximale Anzahl der zurückzugebenden Datensätze. Standardwert ist 100.

• list_bases

  • Listet alle zugänglichen Airtable-Bases auf

  • Keine Eingabeparameter erforderlich

  • Gibt Base-ID, Name und Berechtigungsstufe zurück

• list_tables

  • Listet alle Tabellen in einer bestimmten Base auf

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • detailLevel (string, optional): Der Detailgrad der Informationen über die Tabellen (tableIdentifiersOnly, identifiersOnly oder full)

  • Gibt Tabellen-ID, Name, Beschreibung, Felder und Ansichten zurück (bis zum angegebenen detailLevel)

• describe_table

  • Ruft detaillierte Informationen über eine bestimmte Tabelle ab

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der zu beschreibenden Tabelle

    • detailLevel (string, optional): Der Detailgrad der Informationen über die Tabelle (tableIdentifiersOnly, identifiersOnly oder full)

  • Gibt das gleiche Format wie list_tables zurück, jedoch für eine einzelne Tabelle

  • Nützlich, um Details über eine bestimmte Tabelle zu erhalten, ohne Informationen über alle Tabellen in der Base abzurufen

• get_record

  • Ruft einen bestimmten Datensatz anhand der ID ab

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • recordId (string, erforderlich): Die ID des abzurufenden Datensatzes

• create_record

  • Erstellt einen neuen Datensatz in einer Tabelle

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • fields (object, erforderlich): Die Felder und Werte für den neuen Datensatz

• update_records

  • Aktualisiert einen oder mehrere Datensätze in einer Tabelle

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • records (array, erforderlich): Array von Objekten, die die Datensatz-ID und die zu aktualisierenden Felder enthalten

• delete_records

  • Löscht einen oder mehrere Datensätze aus einer Tabelle

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • recordIds (array, erforderlich): Array der zu löschenden Datensatz-IDs

• create_table

  • Erstellt eine neue Tabelle in einer Base

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • name (string, erforderlich): Name der neuen Tabelle

    • description (string, optional): Beschreibung der Tabelle

    • fields (array, erforderlich): Array von Felddefinitionen (Name, Typ, Beschreibung, Optionen)

• update_table

  • Aktualisiert den Namen oder die Beschreibung einer Tabelle

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • name (string, optional): Neuer Name für die Tabelle

    • description (string, optional): Neue Beschreibung für die Tabelle

• create_field

  • Erstellt ein neues Feld in einer Tabelle

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • name (string, erforderlich): Name des neuen Feldes

    • type (string, erforderlich): Typ des Feldes

    • description (string, optional): Beschreibung des Feldes

    • options (object, optional): Feldspezifische Optionen

• update_field

  • Aktualisiert den Namen oder die Beschreibung eines Feldes

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • fieldId (string, erforderlich): Die ID des Feldes

    • name (string, optional): Neuer Name für das Feld

    • description (string, optional): Neue Beschreibung für das Feld

• create_comment

  • Erstellt einen Kommentar zu einem Datensatz

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • recordId (string, erforderlich): Die ID des Datensatzes

    • text (string, erforderlich): Der Kommentartext

    • parentCommentId (string, optional): Übergeordnete Kommentar-ID für Thread-Antworten

  • Gibt den erstellten Kommentar mit ID, Autor, Erstellungszeitpunkt und Text zurück

• list_comments

  • Listet Kommentare zu einem Datensatz auf

  • Eingabeparameter:

    • baseId (string, erforderlich): Die ID der Airtable-Base

    • tableId (string, erforderlich): Die ID der Tabelle

    • recordId (string, erforderlich): Die ID des Datensatzes

    • pageSize (number, optional): Anzahl der zurückzugebenden Kommentare (max. 100, Standard 100)

    • offset (string, optional): Paginierungs-Offset zum Abrufen weiterer Kommentare

  • Gibt ein Kommentar-Array mit Autor, Text, Zeitstempeln, Reaktionen und Erwähnungen zurück

  • Kommentare werden von neuesten bis ältesten zurückgegeben

HTTP-Transport

Der Server kann auch im HTTP-Modus für die Verwendung mit Remote-MCP-Clients ausgeführt werden:

MCP_TRANSPORT=http PORT=3000 npx airtable-mcp-server

Dies startet einen zustandslosen HTTP-Server unter http://localhost:3000/mcp. Hinweis: Der HTTP-Transport verfügt über keine integrierte Authentifizierung – verwenden Sie ihn nur hinter einem Reverse Proxy oder in einer gesicherten Umgebung.

Mitwirken

Pull Requests sind auf GitHub willkommen! So fangen Sie an:

1. Installieren Sie Git und Node.js

2. Klonen Sie das Repository

3. Installieren Sie Abhängigkeiten mit npm install

4. Führen Sie npm run test aus, um Tests durchzuführen

5. Erstellen Sie den Build mit npm run build

• Sie können npm run build:watch verwenden, um nach dem Bearbeiten von src/index.ts automatisch zu bauen. Das bedeutet, Sie können speichern, Claude Desktop neu laden (mit Strg/Cmd+R) und die Änderungen werden angewendet.

Releases

Versionen folgen der Semantic Versioning-Spezifikation.

So veröffentlichen Sie:

1. Verwenden Sie npm version <major | minor | patch>, um die Version zu erhöhen

2. Führen Sie git push --follow-tags aus, um mit Tags zu pushen

3. Warten Sie, bis GitHub Actions die Veröffentlichung im NPM-Register vornimmt.