airtable-mcp-server

Airtableデータベースへの読み取りおよび書き込みアクセスを提供するModel Context Protocolサーバーです。このサーバーを使用すると、LLMがデータベースのスキーマを検査し、レコードの読み取りや書き込みを行うことができます。

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

インストール

ステップ 1: こちらをクリックしてAirtableのパーソナルアクセストークンを作成します。詳細:

• 名前: 任意（例: 'Airtable MCP Server Token'）

• スコープ: schema.bases:read, data.records:read、およびオプションで schema.bases:write, data.records:write, data.recordComments:read, data.recordComments:write

• アクセス権: アクセスしたいベース。不明な場合は「すべてのリソースを追加」を選択してください。

トークンは次のステップで使用するため、手元に控えておいてください。pat123.abc123 のような形式（より長いもの）になります。

ステップ 2: 使用するクライアントに合わせて以下の手順に従ってください:

• Claude Desktop

• Cursor

• Cline

Claude Desktop

(推奨) 拡張機能ブラウザ経由

1. Claude Desktopを開き、「設定」→「拡張機能」に移動します

2. 「拡張機能をブラウズ」をクリックし、「Airtable MCP Server」を探します

3. 「インストール」をクリックし、APIキーを貼り付けます

(上級者向け) 代替手段: 手動での .mcpb インストール

1. GitHub Actionsの履歴から最新のmcpbビルド（一番上のもの）を探します

2. 「Artifacts」セクションで airtable-mcp-server-mcpb ファイルをダウンロードします

3. .zip ファイルの名前を .mcpb に変更します

4. .mcpb ファイルをダブルクリックしてClaude Desktopで開きます

5. 「インストール」をクリックし、APIキーで設定します

(上級者向け) 代替手段: JSON設定経由

1. Node.jsをインストールします

2. Claude Desktopを開き、「設定」→「開発者」に移動します

3. 「設定を編集」をクリックして claude_desktop_config.json ファイルを開きます

4. "mcpServers" セクションに以下の設定を追加し、pat123.abc123 を自分のAPIキーに置き換えます:

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

5. ファイルを保存し、Claude Desktopを再起動します

Cursor

(推奨) ワンクリックインストール経由

1. をクリックします

2. mcp.json ファイルを編集してAPIキーを挿入します

(上級者向け) 代替手段: JSON設定経由

グローバル設定 (~/.cursor/mcp.json) またはプロジェクト固有の設定 (.cursor/mcp.json) ファイルを作成し、pat123.abc123 を自分のAPIキーに置き換えます:

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

Cline

(推奨) マーケットプレイス経由

1. Cline拡張機能の「MCP Servers」アイコンをクリックします

2. 「Airtable」を検索し、「インストール」をクリックします

3. プロンプトに従ってサーバーをインストールします

(上級者向け) 代替手段: JSON設定経由

1. Cline拡張機能の「MCP Servers」アイコンをクリックします

2. 「インストール済み」タブをクリックし、下部にある「MCPサーバーの設定」ボタンをクリックします

3. "mcpServers" セクションに以下の設定を追加し、pat123.abc123 を自分のAPIキーに置き換えます:

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

Related MCP server: MCP TapData Server

コンポーネント

ツール

• list_records

  • 指定されたAirtableテーブルからレコードを一覧表示します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): クエリ対象のテーブルID

    • maxRecords (数値, オプション): 返すレコードの最大数。デフォルトは100。

    • filterByFormula (文字列, オプション): レコードをフィルタリングするためのAirtable数式

• search_records

  • 特定のテキストを含むレコードを検索します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): クエリ対象のテーブルID

    • searchTerm (文字列, 必須): レコード内で検索するテキスト

    • fieldIds (配列, オプション): 検索対象の特定のフィールドID。指定しない場合は、すべてのテキストベースのフィールドを検索します。

    • maxRecords (数値, オプション): 返すレコードの最大数。デフォルトは100。

• list_bases

  • アクセス可能なすべてのAirtableベースを一覧表示します

  • 入力パラメータは不要です

  • ベースID、名前、権限レベルを返します

• list_tables

  • 特定のベース内のすべてのテーブルを一覧表示します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • detailLevel (文字列, オプション): テーブルに関する取得詳細レベル (tableIdentifiersOnly, identifiersOnly, または full)

  • テーブルID、名前、説明、フィールド、ビューを（指定された detailLevel に応じて）返します

• describe_table

  • 特定のテーブルに関する詳細情報を取得します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): 詳細を取得するテーブルID

    • detailLevel (文字列, オプション): テーブルに関する取得詳細レベル (tableIdentifiersOnly, identifiersOnly, または full)

  • list_tablesと同じ形式で単一テーブルの情報を返します

  • ベース内のすべてのテーブル情報を取得せずに、特定のテーブルの詳細を取得するのに便利です

• get_record

  • IDを指定して特定のレコードを取得します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • recordId (文字列, 必須): 取得するレコードのID

• create_record

  • テーブルに新しいレコードを作成します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • fields (オブジェクト, 必須): 新しいレコードのフィールドと値

• update_records

  • テーブル内の1つ以上のレコードを更新します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • records (配列, 必須): レコードIDと更新するフィールドを含むオブジェクトの配列

• delete_records

  • テーブルから1つ以上のレコードを削除します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • recordIds (配列, 必須): 削除するレコードIDの配列

• create_table

  • ベース内に新しいテーブルを作成します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • name (文字列, 必須): 新しいテーブルの名前

    • description (文字列, オプション): テーブルの説明

    • fields (配列, 必須): フィールド定義の配列（名前、型、説明、オプション）

• update_table

  • テーブルの名前または説明を更新します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • name (文字列, オプション): テーブルの新しい名前

    • description (文字列, オプション): テーブルの新しい説明

• create_field

  • テーブルに新しいフィールドを作成します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • name (文字列, 必須): 新しいフィールドの名前

    • type (文字列, 必須): フィールドの型

    • description (文字列, オプション): フィールドの説明

    • options (オブジェクト, オプション): フィールド固有のオプション

• update_field

  • フィールドの名前または説明を更新します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • fieldId (文字列, 必須): フィールドID

    • name (文字列, オプション): フィールドの新しい名前

    • description (文字列, オプション): フィールドの新しい説明

• create_comment

  • レコードにコメントを作成します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • recordId (文字列, 必須): レコードID

    • text (文字列, 必須): コメントテキスト

    • parentCommentId (文字列, オプション): スレッド返信用の親コメントID

  • ID、作成者、作成日時、テキストを含む作成されたコメントを返します

• list_comments

  • レコードのコメントを一覧表示します

  • 入力パラメータ:

    • baseId (文字列, 必須): AirtableベースのID

    • tableId (文字列, 必須): テーブルID

    • recordId (文字列, 必須): レコードID

    • pageSize (数値, オプション): 返すコメント数（最大100、デフォルト100）

    • offset (文字列, オプション): 追加のコメントを取得するためのページネーションオフセット

  • 作成者、テキスト、タイムスタンプ、リアクション、メンションを含むコメント配列を返します

  • コメントは新しい順に返されます

HTTPトランスポート

サーバーは、リモートMCPクライアントで使用するためにHTTPモードで実行することもできます:

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

これにより、http://localhost:3000/mcp でステートレスなHTTPサーバーが起動します。注意: HTTPトランスポートには組み込みの認証機能はありません。リバースプロキシの背後や安全な環境でのみ使用してください。

コントリビューション

GitHubでのプルリクエストを歓迎します！開始するには:

1. GitとNode.jsをインストールします

2. リポジトリをクローンします

3. npm install で依存関係をインストールします

4. npm run test を実行してテストを実行します

5. npm run build でビルドします

• npm run build:watch を使用すると、src/index.ts を編集した後に自動的にビルドできます。これにより、保存してClaude Desktopをリロード（Ctrl/Cmd+R）するだけで変更が適用されます。

リリース

バージョンは セマンティックバージョニング仕様 に従います。

リリースするには:

1. npm version <major | minor | patch> を使用してバージョンを上げます

2. git push --follow-tags を実行してタグ付きでプッシュします

3. GitHub ActionsがNPMレジストリに公開するのを待ちます。