|
1 | 1 | <div align="center"> |
2 | 2 |
|
3 | | -<img src="https://raw.githubusercontent.com/Automations-Project/VSCode-Airtable-Formula/main/packages/webview/src/assets/icons/airtable.svg" alt="Airtable Formulas, Scripts, Automation, MCP & LSP" width="80" /> |
| 3 | +<img src="https://raw.githubusercontent.com/Automations-Project/VSCode-Airtable-Formula/main/packages/mcp-server/assets/banner.svg" alt="airtable-user-mcp — 66 tools your AI assistant can't get from the official Airtable REST API" width="900" /> |
4 | 4 |
|
5 | 5 | # Airtable Formulas, Scripts, Automation, MCP & LSP |
6 | 6 |
|
|
32 | 32 |
|
33 | 33 | > **Not affiliated with Airtable Inc.** This is a community-maintained project. |
34 | 34 | > |
35 | | -> **Experimental** — This project is under active development and not intended for production use. APIs, tools, and behavior may change without notice. |
| 35 | +> **Active development** — Breaking changes may land between minor versions. Pin to a version if you need stability. |
36 | 36 |
|
37 | 37 | </div> |
38 | 38 |
|
@@ -61,6 +61,10 @@ Airtable's public Web API has never exposed some of the most common tasks builde |
61 | 61 |
|
62 | 62 | **`airtable-user-mcp` is an add-on to the official Airtable MCP, not a replacement.** It uses Airtable's own internal API (the one the web UI uses) to cover exactly the surface area the REST API can't reach. Register both servers in your AI client and your assistant gets the full Airtable automation experience — records over HTTP via the official MCP, plus schema, formulas, views, and extensions via this one. |
63 | 63 |
|
| 64 | +<div align="center"> |
| 65 | +<img src="https://raw.githubusercontent.com/Automations-Project/VSCode-Airtable-Formula/main/packages/mcp-server/assets/architecture.svg" alt="Architecture: AI Client → Official MCP + airtable-user-mcp → Airtable" width="900" /> |
| 66 | +</div> |
| 67 | + |
64 | 68 | --- |
65 | 69 |
|
66 | 70 | ## What `airtable-user-mcp` adds on top of the official Airtable MCP |
@@ -113,6 +117,11 @@ This is a coverage map, not a "pick one" decision — the two servers are comple |
113 | 117 |
|
114 | 118 | ## Use both MCPs together |
115 | 119 |
|
| 120 | +```bash |
| 121 | +npx -y airtable-user-mcp login # one-time browser login |
| 122 | +claude mcp add airtable --scope user -- npx -y airtable-user-mcp # Claude Code |
| 123 | +``` |
| 124 | + |
116 | 125 | `airtable-user-mcp` is additive. Register the official Airtable MCP following [Airtable's setup guide](https://support.airtable.com/docs/using-the-airtable-mcp-server), then add this one alongside it in the same `mcpServers` block: |
117 | 126 |
|
118 | 127 | ```json |
@@ -158,15 +167,6 @@ This monorepo ships **three products** from one source tree: |
158 | 167 |
|
159 | 168 | ## Features |
160 | 169 |
|
161 | | -### VS Code Extension |
162 | | - |
163 | | -- **Formula Editor** — Syntax highlighting, IntelliSense, beautify / minify for `.formula` files |
164 | | -- **MCP Server** — One-click MCP registration for multiple IDEs |
165 | | -- **AI Skills** — Auto-install Airtable-specific skills, rules, and workflows for AI coding assistants |
166 | | -- **Airtable Login** — Credentials in OS keychain, browser-based auth with auto-refresh |
167 | | -- **Dashboard** — React webview with Overview, Setup, and Settings tabs |
168 | | - |
169 | | - |
170 | 170 | ### MCP Server (66 Tools) |
171 | 171 |
|
172 | 172 | Manage Airtable bases with capabilities **not available through the official REST API**: |
|
0 commit comments