airtable-mcp-server

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona acceso de lectura y escritura a bases de datos de Airtable. Este servidor permite a los LLM inspeccionar esquemas de bases de datos y, posteriormente, leer y escribir registros.

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

Instalación

Paso 1: Cree un token de acceso personal de Airtable haciendo clic aquí. Detalles:

• Nombre: El que desee, p. ej., 'Airtable MCP Server Token'.

• Alcances (Scopes): schema.bases:read, data.records:read y, opcionalmente, schema.bases:write, data.records:write, data.recordComments:read y data.recordComments:write.

• Acceso: Las bases a las que desea acceder. Si no está seguro, seleccione 'Add all resources'.

Mantenga el token a mano, lo necesitará en el siguiente paso. Debería verse algo como pat123.abc123 (pero más largo).

Paso 2: Siga las instrucciones a continuación para su cliente preferido:

• Claude Desktop

• Cursor

• Cline

Claude Desktop

(Recomendado) A través del navegador de extensiones

1. Abra Claude Desktop y vaya a Settings → Extensions

2. Haga clic en 'Browse Extensions' y busque 'Airtable MCP Server'

3. Haga clic en 'Install' y pegue su clave API

(Avanzado) Alternativa: A través de instalación manual de .mcpb

1. Busque la compilación mcpb más reciente en el historial de GitHub Actions (la superior)

2. En la sección 'Artifacts', descargue el archivo airtable-mcp-server-mcpb

3. Cambie el nombre del archivo .zip a .mcpb

4. Haga doble clic en el archivo .mcpb para abrirlo con Claude Desktop

5. Haga clic en "Install" y configure con su clave API

(Avanzado) Alternativa: A través de configuración JSON

1. Instale Node.js

2. Abra Claude Desktop y vaya a Settings → Developer

3. Haga clic en "Edit Config" para abrir su archivo claude_desktop_config.json

4. Añada la siguiente configuración a la sección "mcpServers", reemplazando pat123.abc123 con su clave API:

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

5. Guarde el archivo y reinicie Claude Desktop

Cursor

(Recomendado) A través de instalación con un clic

1. Haga clic en

2. Edite su archivo mcp.json para insertar su clave API

(Avanzado) Alternativa: A través de configuración JSON

Cree un archivo de configuración global (~/.cursor/mcp.json) o específico del proyecto (.cursor/mcp.json), reemplazando pat123.abc123 con su clave API:

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

Cline

(Recomendado) A través del marketplace

1. Haga clic en el icono "MCP Servers" en la extensión Cline

2. Busque "Airtable" y haga clic en "Install"

3. Siga las instrucciones para instalar el servidor

(Avanzado) Alternativa: A través de configuración JSON

1. Haga clic en el icono "MCP Servers" en la extensión Cline

2. Haga clic en la pestaña "Installed", luego en el botón "Configure MCP Servers" en la parte inferior

3. Añada la siguiente configuración a la sección "mcpServers", reemplazando pat123.abc123 con su clave API:

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

Related MCP server: MCP TapData Server

Componentes

Herramientas

• list_records

  • Enumera los registros de una tabla de Airtable especificada

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla a consultar

    • maxRecords (número, opcional): Número máximo de registros a devolver. Por defecto es 100.

    • filterByFormula (cadena, opcional): Fórmula de Airtable para filtrar registros

• search_records

  • Busca registros que contengan texto específico

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla a consultar

    • searchTerm (cadena, requerido): Texto a buscar en los registros

    • fieldIds (matriz, opcional): IDs de campos específicos en los que buscar. Si no se proporciona, busca en todos los campos basados en texto.

    • maxRecords (número, opcional): Número máximo de registros a devolver. Por defecto es 100.

• list_bases

  • Enumera todas las bases de Airtable accesibles

  • No se requieren parámetros de entrada

  • Devuelve el ID de la base, el nombre y el nivel de permiso

• list_tables

  • Enumera todas las tablas en una base específica

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • detailLevel (cadena, opcional): La cantidad de detalle a obtener sobre las tablas (tableIdentifiersOnly, identifiersOnly o full)

  • Devuelve el ID de la tabla, el nombre, la descripción, los campos y las vistas (según el detailLevel dado)

• describe_table

  • Obtiene información detallada sobre una tabla específica

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla a describir

    • detailLevel (cadena, opcional): La cantidad de detalle a obtener sobre la tabla (tableIdentifiersOnly, identifiersOnly o full)

  • Devuelve el mismo formato que list_tables pero para una sola tabla

  • Útil para obtener detalles sobre una tabla específica sin obtener información sobre todas las tablas de la base

• get_record

  • Obtiene un registro específico por ID

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • recordId (cadena, requerido): El ID del registro a recuperar

• create_record

  • Crea un nuevo registro en una tabla

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • fields (objeto, requerido): Los campos y valores para el nuevo registro

• update_records

  • Actualiza uno o más registros en una tabla

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • records (matriz, requerido): Matriz de objetos que contienen el ID del registro y los campos a actualizar

• delete_records

  • Elimina uno o más registros de una tabla

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • recordIds (matriz, requerido): Matriz de IDs de registros a eliminar

• create_table

  • Crea una nueva tabla en una base

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • name (cadena, requerido): Nombre de la nueva tabla

    • description (cadena, opcional): Descripción de la tabla

    • fields (matriz, requerido): Matriz de definiciones de campo (nombre, tipo, descripción, opciones)

• update_table

  • Actualiza el nombre o la descripción de una tabla

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • name (cadena, opcional): Nuevo nombre para la tabla

    • description (cadena, opcional): Nueva descripción para la tabla

• create_field

  • Crea un nuevo campo en una tabla

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • name (cadena, requerido): Nombre del nuevo campo

    • type (cadena, requerido): Tipo del campo

    • description (cadena, opcional): Descripción del campo

    • options (objeto, opcional): Opciones específicas del campo

• update_field

  • Actualiza el nombre o la descripción de un campo

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • fieldId (cadena, requerido): El ID del campo

    • name (cadena, opcional): Nuevo nombre para el campo

    • description (cadena, opcional): Nueva descripción para el campo

• create_comment

  • Crea un comentario en un registro

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • recordId (cadena, requerido): El ID del registro

    • text (cadena, requerido): El texto del comentario

    • parentCommentId (cadena, opcional): ID del comentario padre para respuestas en hilo

  • Devuelve el comentario creado con ID, autor, hora de creación y texto

• list_comments

  • Enumera los comentarios en un registro

  • Parámetros de entrada:

    • baseId (cadena, requerido): El ID de la base de Airtable

    • tableId (cadena, requerido): El ID de la tabla

    • recordId (cadena, requerido): El ID del registro

    • pageSize (número, opcional): Número de comentarios a devolver (máx. 100, por defecto 100)

    • offset (cadena, opcional): Desplazamiento de paginación para recuperar comentarios adicionales

  • Devuelve una matriz de comentarios con autor, texto, marcas de tiempo, reacciones y menciones

  • Los comentarios se devuelven del más reciente al más antiguo

Transporte HTTP

El servidor también puede ejecutarse en modo HTTP para su uso con clientes MCP remotos:

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

Esto inicia un servidor HTTP sin estado en http://localhost:3000/mcp. Tenga en cuenta que el transporte HTTP no tiene autenticación integrada: utilícelo solo detrás de un proxy inverso o en un entorno seguro.

Contribución

¡Las solicitudes de extracción (pull requests) son bienvenidas en GitHub! Para empezar:

1. Instale Git y Node.js

2. Clone el repositorio

3. Instale las dependencias con npm install

4. Ejecute npm run test para ejecutar las pruebas

5. Compile con npm run build

• Puede usar npm run build:watch para compilar automáticamente después de editar src/index.ts. Esto significa que puede guardar, recargar Claude Desktop (con Ctrl/Cmd+R) y los cambios se aplicarán.

Lanzamientos

Las versiones siguen la especificación de versionado semántico.

Para lanzar:

1. Use npm version <major | minor | patch> para aumentar la versión

2. Ejecute git push --follow-tags para enviar con etiquetas

3. Espere a que GitHub Actions publique en el registro de NPM.