airtable-mcp-server MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Scoping granular de PAT — otorga acceso solo lectura o por base de forma explícita
CRUD completo de registros más operaciones a nivel de esquema (create_table, create_field)
search_records con filtrado opcional de campos
API de Comentarios — lee, crea e inicia hilos de respuestas
Modo de transporte HTTP (MCP_TRANSPORT=http PORT=3000) para clientes remotos

Demo en vivo

Cómo se ve en la práctica

airtable.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "airtable",
      "command": "npx",
      "args": [
        "-y",
        "airtable-mcp-server"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "airtable": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "airtable-mcp-server"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add airtable -- npx -y airtable-mcp-server

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: airtable-mcp-server

Responde preguntas en lenguaje natural sobre tu CRM en Airtable

👤 Fundadores y personas de operaciones que usan Airtable como CRM ⏱ ~10 min beginner

Cuándo usarlo: Quieres saber '¿quién no ha respondido en 30 días?' sin construir una vista.

Requisitos previos

PAT de Airtable con schema.bases:read + data.records:read — airtable.com/create/tokens/new — selecciona solo las bases que quieres exponer

Flujo

Que Claude liste las bases y elige la correcta

Lista mis bases de Airtable. Encuentra la que se parece a un CRM de ventas y describe sus tablas.✓ Copiado

→ Esquema de la base del CRM con los propósitos de las tablas
Haz la pregunta real

En la tabla Contactos, encuentra personas donde Último Contacto hace más de 30 días y Estado es Activo. Agrupa por Propietario.✓ Copiado

→ Lista de registros filtrada por propietario
Redacta acciones de seguimiento

Para cada contacto, redacta un email de recordatorio de una línea que pueda enviar. Adapta el tono de su última conversación.✓ Copiado

→ Texto borrador por contacto

Resultado: Una lista de siguientes acciones directamente desde el CRM en 2 minutos.

Errores comunes

Los campos de registros vinculados devuelven IDs, no nombres — Pide a Claude que resuelva registros vinculados mediante una segunda búsqueda, o usa list_records con returnFieldsByFieldId=false
Las bases empresariales a menudo tienen restricciones de permiso por campo — Verifica que el acceso del espacio de trabajo de tu PAT coincida con la política empresarial de la base

Combinar con: notion

Limpia en lote registros desordenados de Airtable

👤 Administradores de operaciones que heredan una base caótica ⏱ ~45 min intermediate

Cuándo usarlo: Una tabla tiene 3k filas con mayúsculas inconsistentes, campos faltantes, empresas duplicadas.

Requisitos previos

PAT con data.records:write — Añade el scope al crear el token; mantén el scope de base limitado

Flujo

Audita el desorden

En Empresas, encuentra duplicados por nombre normalizado, registros sin Dominio, y registros con Sitio Web que comienza con http:// en lugar de https://.✓ Copiado

→ Conteo por problema
Ejecuta un ensayo de plan de corrección

Para cada problema, propón una corrección y muéstrame 3 cambios de ejemplo ANTES de escribir.✓ Copiado

→ Vista previa con puerta de aprobación del usuario
Aplica las correcciones aprobadas

Aprobado. Aplica las correcciones en lotes de 50 con update_records.✓ Copiado

→ Conteos de éxito por lote

Resultado: Una tabla limpia con una lista auditable de qué cambió.

Errores comunes

Las actualizaciones masivas activan las cuotas de automatización por token de Airtable — Agrupa a máximo 10/s; pausa las automatizaciones de la tabla afectada durante operaciones en lote
Un patrón de actualización incorrecto arruina 500 filas — Haz una instantánea de la tabla (exportación CSV) antes de la primera escritura

Combinar con: filesystem

Usa Airtable como CMS sin cabeza para un sitio web

👤 Desarrolladores independientes y equipos de contenido ⏱ ~30 min intermediate

Cuándo usarlo: Quieres editores en Airtable y lógica de publicación impulsada por un agente.

Flujo

Extrae registros listos para publicar

De la tabla Blog, lista registros donde Estado es 'Listo' y FechaPublicación es hoy o anterior.✓ Copiado

→ Cola de publicación
Transforma y emite

Para cada uno, convierte el campo Body de texto enriquecido a Markdown y escribe en /site/content/posts/<slug>.md.✓ Copiado

→ Los archivos aparecen en el disco
Cambia el estado de vuelta

Actualiza el Estado de cada registro a 'Publicado' y establece PublicadoEn a ahora.✓ Copiado

→ Filas cambiadas

Resultado: Un flujo de publicación de un comando con Airtable como fuente de verdad.

Combinar con: filesystem · github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

airtable + notion

Convierte un informe de Airtable en una sesión informativa de Notion

Extrae los Tratos nuevos de esta semana del CRM, luego crea una página en Notion en /Sales con una tabla de resumen.✓ Copiado

airtable + filesystem

Usa Airtable como CMS, emite archivos Markdown

Para cada registro de Blog con Status=Listo, escribe un archivo .md bajo ./content/posts/ y cambia el registro a Publicado.✓ Copiado

airtable + github

Crea automáticamente problemas de GitHub desde un backlog de errores de Airtable

Para cada Error en la vista Triage con Severity=Alto, abre un problema de GitHub en acme/api con título y pasos de reproducción.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
list_bases	(ninguno)	Descubrimiento por primera vez	1 llamada API
list_tables	baseId: str, detailLevel?: str	Mapea una base antes de consultar	1 llamada API
describe_table	baseId: str, tableId: str	Conoce los campos antes de filtrar	1 llamada API
list_records	baseId, tableId, view?, filterByFormula?, sort?, pageSize?	Lee datos con filtros/ordenamiento	1 llamada API (pagina)
search_records	baseId, tableId, searchTerm, fieldIds?	Búsqueda de texto libre en campos	1 llamada API
get_record	baseId, tableId, recordId	Obtén un registro único conocido	1 llamada API
create_record	baseId, tableId, fields	Inserta un registro	1 llamada API (escritura)
update_records	baseId, tableId, records[]	Actualizaciones en lote	1 llamada API por cada 10 registros
delete_records	baseId, tableId, recordIds	Destructivo — confirma primero	1 llamada API (escritura)
create_table	baseId, name, fields[]	Inicia un nuevo modelo de datos	1 llamada API (escritura de esquema)
list_comments	baseId, tableId, recordId, offset?, pageSize?	Lee el historial de hilos	1 llamada API

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: 5 solicitudes/seg por base (Team), 50/seg en Enterprise Scale
Tokens por llamada: Esquema: ~500 tokens. Respuestas de registros: 200 tokens por fila según los campos.
Monetario: Airtable gratuito/Team/Enterprise — acceso API en todos los planes pagos; el plan gratuito también expone API
Consejo: Usa pageSize y filterByFormula del lado del servidor; extraer una tabla completa al contexto es derrochador.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: schema.bases:read data.records:read

Almacenamiento de credenciales: PAT de grano fino en variable de entorno AIRTABLE_API_KEY; nunca tokens de usuario clásicos

Salida de datos: Todas las llamadas a api.airtable.com sobre HTTPS

No conceder nunca: Acceso a todas las bases cuando solo se necesita una base webhook:manage a menos que sea requerido

Limita el PAT a bases específicas, no 'todas las bases en el espacio de trabajo'.
Si usas transporte HTTP, pon un proxy inverso con autenticación al frente — sin autenticación integrada.

Resolución de problemas

Errores comunes y soluciones

401 INVALID_API_KEY

PAT faltante o vencido. Regenera en airtable.com/create/tokens.

Verificar: curl -H 'Authorization: Bearer $AIRTABLE_API_KEY' https://api.airtable.com/v0/meta/bases

403 NOT_AUTHORIZED

El PAT no incluye esa base. Edita la lista de scopes del token y añade la base.

Verificar: curl devuelve las bases que esperas

422 INVALID_REQUEST_UNKNOWN_FIELD

El nombre del campo no coincide con el esquema. Redescribe la tabla — Airtable cambia los IDs de los campos si se renombran.

Verificar: llama describe_table de nuevo

429 rate limit

Reduce a 5 req/seg por base; agrupa operaciones de escritura.

Verificar: reintenta después de 30 seg

Alternativas

airtable-mcp-server vs otros

Alternativa	Cuándo usarla	Contrapartida
Notion MCP	Tu equipo vive en bases de datos de Notion en lugar de Airtable	Notion es menos tabular; peor para operaciones de datos en lote
Google Sheets MCP	Los datos están en Sheets	Sin esquema estructurado ni registros vinculados
Direct Airtable REST via fetch MCP	Quieres llamadas puntuales y no quieres otro MCP	Escribes cada URL a mano

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills