Skip to content

Commit ede23ba

Browse files
committed
docs: replace icon with banner SVG and update experimental warning
Root + mcp-server README: - Replace icon.png/airtable.svg with banner.svg (900px wide) in header - Add architecture.svg diagram below "What airtable-user-mcp adds" section - Update disclaimer: "Experimental" → "Active development" with version pinning advice - Root: move quick-start snippet above JSON config block - Root: remove "VS Code Extension" feature section (redundant with monorepo intro) Co-Authored-By: Claude Sonnet
1 parent b176648 commit ede23ba

4 files changed

Lines changed: 305 additions & 13 deletions

File tree

README.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<div align="center">
22

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" />
44

55
# Airtable Formulas, Scripts, Automation, MCP & LSP
66

@@ -32,7 +32,7 @@
3232

3333
> **Not affiliated with Airtable Inc.** This is a community-maintained project.
3434
>
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.
3636
3737
</div>
3838

@@ -61,6 +61,10 @@ Airtable's public Web API has never exposed some of the most common tasks builde
6161

6262
**`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.
6363

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+
6468
---
6569

6670
## 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
113117

114118
## Use both MCPs together
115119

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+
116125
`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:
117126

118127
```json
@@ -158,15 +167,6 @@ This monorepo ships **three products** from one source tree:
158167

159168
## Features
160169

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-
170170
### MCP Server (66 Tools)
171171

172172
Manage Airtable bases with capabilities **not available through the official REST API**:

packages/mcp-server/README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<div align="center">
22

3-
<img src="https://raw.githubusercontent.com/Automations-Project/VSCode-Airtable-Formula/main/packages/mcp-server/assets/icon.png" alt="Airtable User MCP" width="140" />
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" />
44

55
# airtable-user-mcp
66

@@ -26,7 +26,7 @@
2626

2727
> **Not affiliated with Airtable Inc.** This is a community-maintained project.
2828
>
29-
> **Experimental**This project is under active development and not intended for production use. APIs, tools, and behavior may change without notice.
29+
> **Active development**Breaking changes may land between minor versions. Pin to a version if you need stability.
3030
3131
</div>
3232

@@ -53,6 +53,10 @@ The official Airtable MCP can't — its REST API doesn't expose those surfaces.
5353

5454
The official Airtable MCP is a thin wrapper over the public Web API. That API — by design — never exposed some of the most-requested automation surfaces in Airtable. `airtable-user-mcp` uses Airtable's **internal API** (the same one the web UI calls) to close the gap. The two servers cover different surfaces, so the intended setup is **both installed at once** — your MCP client sees the union of their tool sets.
5555

56+
<div align="center">
57+
<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" />
58+
</div>
59+
5660
### Coverage map
5761

5862
| Capability | Official Airtable MCP | **airtable-user-mcp** |
Lines changed: 140 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)