Airtable MCP Server

社区

通过 MCP 协议为 AI 应用提供完整的 Airtable 数据与架构操作能力

分类: 数据库第 16 / 58
Stars: ★ 87 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 20+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 个月前
工具数: 42

61FMRS · C

一个功能全面的第三方 Airtable MCP 服务器，覆盖记录、架构、批量操作、Webhook、评论和治理控制共42个工具，并支持 stdio 与流式 HTTP 两种传输方式及新旧协议版本客户端；适合已使用 Airtable 且需要 AI 深度集成的团队，但作为社区维护项目，需自行关注令牌安全与写操作风险。

最强项 · 文档质量 16/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

11/20

维护活跃度

13/20

文档质量

16/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: 本次为静态审查，未缓存 manifest，也没有提供 CI workflow 文件或实际测试代码内容,仅在 README 中提及 `npm test`/`npm run test:types` 命令,无法验证42个工具的声明行为与实际实现是否一致。README 自述 npx 在某些目录下会出现二进制解析失败,需要 `cd /tmp &&` 变通,这本身暴露出启动路径存在已知脆弱性。同时声称同时兼容 2026-07-28 与旧版协议(双协议兼容、无状态核心)但缺乏可验证证据。按静态校准规则,在没有真实 CI + 测试覆盖证据的情况下不得给出 12 分以上,综合来看仅处于“主路径看似合理但证据稀薄”的水平。
安全与权限 11/20: 凭证通过环境变量 `AIRTABLE_TOKEN` 传入,示例中未包含真实密钥,权限范围表列出较细粒度的 PAT scope,这是积极信号。但 Quick Start 建议“grant all scopes listed”而非按最小需要申请,弱化了最小权限原则。工具列表中 `create`/`update` 声明“requires dryRun diff review”,`delete_table`/`delete_field` 声明“requires confirmation”,但 `delete_record`、`batch_delete_records`、`delete_webhook`、`delete_comment` 等破坏性操作未在文档中说明是否有确认机制,存在不一致的安全设计,构成明显缺口。此外,Claude Code 一键安装方式为 `curl -fsSL ... | bash`,属于未经审查直接执行远程脚本的常见风险模式。以上问题尚不构成“默认无确认即执行不可逆操作”的明确红线证据(因为高危的表/字段级删除有确认要求),因此未评为0-4分红线,但需要在10-12分区间内扣分。
维护活跃度 13/20: 仓库使用 MIT 许可证,版本号 5.1.0,README 链接了 CHANGELOG 与 release notes 目录,表明存在版本管理与发布记录。87 星、0 未关闭 issue,但无法判断是社区参与度低还是响应迅速,证据不足。未见 SECURITY.md 或明确的安全问题上报渠道,也没有可验证的近期提交/发布时间线证据。整体呈现“持续维护迹象”但治理与安全响应渠道存在缺口。
文档质量 16/20: README 内容较为详尽:面向多个客户端(Claude Desktop、Claude Code、Codex、Cursor、Windsurf、VS Code)的安装示例、token scope 表、环境变量表、完整的42个工具列表及简要说明、10个AI提示模板、故障排查章节、项目结构说明均已覆盖,层次较为清晰。但工具级别的输入参数/输出结构未提供(仅一句话描述),没有速率限制、API 配额或成本方面的说明,故障排查部分也偏通用而非针对具体工具错误码,故不能给满分。
安装易用性 13/20: 提供了 npx 免安装方式及一键 curl 安装脚本,并为多个主流客户端给出了具体配置示例,步骤总体清晰、达成连接所需操作不多。但根据静态校准规则,在没有可验证执行证据(真实 CI + 测试覆盖关键路径)的情况下,setup 分数不得超过15分。同时 README 自曝的 npx 二进制解析问题及相应变通方案说明安装路径并非完全稳健,因此在校准上限内进一步扣分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据连接数据库

适合谁

已在使用 Airtable 管理项目、任务或客户数据，并希望通过 AI 助手直接操作的团队
需要将 Airtable 数据自动化流程集成进 Claude、Codex、Cursor 等 MCP 客户端的开发者
希望利用治理与 PII 屏蔽功能对 AI 访问数据进行合规控制的场景

不适合谁

不使用 Airtable 的用户
需要绝对官方支持保证的企业（本项目为第三方社区维护，非 Airtable 官方产品）
无法接受通过 npx 每次拉取远程 npm 包运行的安全策略环境

所需权限

data.records:read — 读取记录
data.records:write — 创建、更新、删除记录
data.recordComments:read — 读取记录评论
data.recordComments:write — 创建、更新、删除评论
schema.bases:read — 查看表结构
schema.bases:write — 创建和修改表与字段
user.email:read — 读取用户身份（whoami）
webhook:manage — 管理 Webhook（可选）

风险与副作用

该服务器可对 Airtable 数据和结构进行写入、修改乃至删除操作，误操作或提示注入可能导致数据丢失或损坏，尽管 create/update 要求 dryRun 差异预览
Personal Access Token 以明文形式存放在客户端配置文件的环境变量中，需妥善保管配置文件访问权限
该服务器为第三方维护（非 Airtable 官方），通过 npx 每次运行时从 npm 拉取最新包，存在供应链更新引入非预期行为的风险
delete_table、delete_field、batch_delete_records 等操作具有破坏性，虽部分需要确认，但仍应谨慎审查授权范围

安装接入

准备工作

运行环境：Node.js 20+

AIRTABLE_TOKEN 必填密钥 Airtable 个人访问令牌（必填），在 airtable.com/create/tokens 创建，需授予 README 列出的所有 scopes。

其他可选配置项（4 个）

AIRTABLE_BASE_ID 可选可选的默认 base ID，可从 base 页面 URL 中获取，或省略后用 list_bases 动态发现。

AIRTABLE_TOOLSET 可选可选，控制注册哪些工具：full（默认全部 42 个）、core（18 个记录类工具，适配 Cursor 的 40 工具上限）或逗号分隔的工具名白名单。

LOG_LEVEL 可选可选，日志级别，默认 info。

MCP_HTTP_PORT 可选可选，设置后启用 HTTP 传输以用于托管部署。

在 airtable.com/create/tokens 创建 Airtable 个人访问令牌，并授予文档中列出的所有 Token Scopes。
获取 Base ID（可从查看基地时的 URL 中获取，也可省略并用 list_bases 工具动态发现）。
Claude Desktop：编辑配置文件（macOS: ~/Library/Application Support/Claude/claude_desktop_config.json；Windows: %APPDATA%\Claude\claude_desktop_config.json），添加 mcpServers 中的 airtable 配置块，填入 AIRTABLE_TOKEN（和可选的 AIRTABLE_BASE_ID），保存后重启 Claude Desktop。
Claude Code：运行一键安装脚本 curl -fsSL https://raw.githubusercontent.com/rashidazarang/airtable-mcp/main/setup.sh | bash，或手动编辑 ~/.claude.json。
Codex/Cursor/Windsurf/VS Code：按各自客户端的 MCP 配置文件添加相同的 npx 启动命令和环境变量。
如客户端限制可启用工具数量（如 Cursor 上限40个），设置 AIRTABLE_TOOLSET=core 或指定工具白名单。

claude_desktop_config.json

{"mcpServers":{"airtable":{"command":"npx","args":["-y","@rashidazarang/airtable-mcp"],"env":{"AIRTABLE_TOKEN":"YOUR_AIRTABLE_TOKEN","AIRTABLE_BASE_ID":"YOUR_BASE_ID"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "airtable": {
      "command": "npx",
      "args": [
        "-y",
        "@rashidazarang/airtable-mcp"
      ],
      "env": {
        "AIRTABLE_TOKEN": "YOUR_AIRTABLE_TOKEN",
        "AIRTABLE_BASE_ID": "YOUR_BASE_ID"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add airtable -e AIRTABLE_TOKEN=YOUR_AIRTABLE_TOKEN -e AIRTABLE_BASE_ID=YOUR_BASE_ID -- npx -y @rashidazarang/airtable-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Desktop 中添加配置并重启后，应能在工具列表中看到 whoami 和 list_bases；询问“列出我所有可访问的 bases”即可验证连接是否成功。

常见排障

连接问题：确认 MCP 服务器正在运行，重启 MCP 客户端
令牌无效：检查 Personal Access Token 是否正确、拥有所需权限范围，并确认凭据中没有多余空格
找不到 Base：确认 Base ID 正确，验证令牌有权访问该基地，或使用 list_bases 工具动态发现可访问的基地
Cursor 等限制工具数量的客户端：设置 AIRTABLE_TOOLSET=core 或使用逗号分隔的工具白名单以控制启用的工具数

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我所有可访问的 Airtable bases
显示 Projects 表中的全部记录
创建一个新任务，优先级为 High，截止日期为明天
为记录 rec123 添加评论：已审核并批准

工具能力 42

list_bases 只读

列出所有可访问的 Airtable 基地及权限

describe 只读

描述基地或表的架构（支持不同详细程度）

query 只读

按条件筛选、排序和分页查询记录

search_records 只读

使用 Airtable 公式进行高级搜索

list_records 只读

列出记录，支持字段选择和分页

get_record 只读

通过 ID 获取单条记录

create 写入

创建新记录（需要 dryRun 差异预览确认）

update 写入

更新现有记录（需要 dryRun 差异预览确认）

展开其余 34 个工具

delete_record 破坏性

从表中删除一条记录

upsert 写入

根据合并字段更新或创建记录

batch_upsert_records 写入

基于合并字段批量更新或创建记录

list_tables 只读

获取基地内所有表及其架构信息

get_base_schema 只读

获取任意基地的完整架构

list_field_types 只读

可用字段类型参考指南

get_table_views 只读

列出某个表的所有视图

create_table 写入

使用自定义字段定义创建表

update_table 写入

修改表名称和描述

delete_table 破坏性

删除表（需要确认）

create_field 写入

向现有表添加字段

update_field 写入

修改字段属性和选项

delete_field 破坏性

删除字段（需要确认）

batch_create_records 写入

一次性创建最多10条记录

batch_update_records 写入

同时更新最多10条记录

batch_delete_records 破坏性

一次操作删除最多10条记录

list_webhooks 只读

查看所有已配置的 Webhook

create_webhook 写入

设置实时数据变更通知

delete_webhook 破坏性

移除 Webhook 配置

get_webhook_payloads 只读

获取通知历史记录

refresh_webhook 写入

延长 Webhook 过期时间

create_view 写入

创建视图（表格、表单、日历等）

get_view_metadata 只读

获取视图详情，包括筛选条件

upload_attachment 写入

通过 URL 附加文件

create_base 写入

创建具有初始结构的新基地

list_collaborators 只读

查看协作者及其权限

list_shares 只读

列出共享视图及其配置

list_comments 只读

列出记录上的评论

create_comment 写入

为记录添加评论

update_comment 写入

编辑现有评论

delete_comment 破坏性

删除评论

whoami 只读

获取当前用户身份和权限范围

list_governance 只读

返回治理允许列表和 PII 屏蔽策略

list_exceptions 只读

列出近期异常和修复建议

使用场景

用自然语言查询、筛选和更新 Airtable 表中的记录

通过对话创建和修改表结构、字段与视图

批量创建、更新或删除记录以提升自动化效率

为数据变更设置 Webhook 实时通知

对记录添加、编辑和管理评论

使用内置 AI 提示模板做数据洞察、质量审计和预测分析

支持客户端

Claude Desktop

Claude Code

Codex

Cursor部分支持

Windsurf

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Airtable MCP Server 是一个基于 Model Context Protocol 的服务器，为 Claude、Codex、Cursor、Windsurf、VS Code 等任意 MCP 客户端提供对 Airtable 的完整集成。它支持记录的增删改查、表和字段的架构管理、批量操作（每次最多10条记录）、Webhook 管理、记录评论、治理与合规控制（允许列表、PII 屏蔽），以及10个用于数据分析的 AI 提示模板。服务器同时支持 stdio 本地传输和可流式的 HTTP 远程传输，并兼容新旧两代 MCP 协议客户端。