@rashidazarang/airtable-mcp 1.4.0 → 1.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/DEVELOPMENT.md +1 -0
- package/MCP_REVIEW_SUMMARY.md +1 -0
- package/README.md +142 -15
- package/RELEASE_NOTES_v1.2.3.md +1 -0
- package/RELEASE_NOTES_v1.5.0.md +185 -0
- package/RELEASE_NOTES_v1.6.0.md +248 -0
- package/airtable_simple.js +911 -3
- package/cleanup.sh +1 -0
- package/inspector_server.py +1 -1
- package/package.json +1 -1
- package/quick_test.sh +1 -0
- package/test_mcp_comprehensive.js +1 -0
- package/test_v1.5.0_comprehensive.sh +96 -0
- package/test_v1.5.0_final.sh +224 -0
- package/test_v1.6.0_comprehensive.sh +187 -0
package/DEVELOPMENT.md
CHANGED
package/MCP_REVIEW_SUMMARY.md
CHANGED
package/README.md
CHANGED
|
@@ -2,22 +2,29 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://smithery.ai/server/@rashidazarang/airtable-mcp)
|
|
4
4
|

|
|
5
|
-
[](https://github.com/rashidazarang/airtable-mcp)
|
|
6
6
|
|
|
7
7
|
A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your Airtable bases. Query, create, update, and delete records using natural language through a secure, standardized interface.
|
|
8
8
|
|
|
9
9
|
## 🔒 Security Notice
|
|
10
10
|
|
|
11
|
-
**Important**: Version 1.
|
|
11
|
+
**Important**: Version 1.6.0 adds batch operations and attachment management with 33 total tools. Complete Airtable API coverage with advanced features.
|
|
12
12
|
|
|
13
13
|
## ✨ Features
|
|
14
14
|
|
|
15
15
|
- 🔍 **Natural Language Queries** - Ask questions about your data in plain English
|
|
16
16
|
- 📊 **Full CRUD Operations** - Create, read, update, and delete records
|
|
17
|
-
-
|
|
17
|
+
- 🪝 **Webhook Management** - Create and manage webhooks for real-time notifications
|
|
18
|
+
- 🏗️ **Advanced Schema Management** - Create tables, fields, and manage base structure
|
|
19
|
+
- 🔍 **Base Discovery** - Explore all accessible bases and their schemas
|
|
20
|
+
- 🔧 **Field Management** - Add, modify, and remove fields programmatically
|
|
18
21
|
- 🔐 **Secure Authentication** - Uses environment variables for credentials
|
|
19
22
|
- 🚀 **Easy Setup** - Multiple installation options available
|
|
20
23
|
- ⚡ **Fast & Reliable** - Built with Node.js for optimal performance
|
|
24
|
+
- 🎯 **33 Powerful Tools** - Complete Airtable API coverage with batch operations
|
|
25
|
+
- 📎 **Attachment Management** - Upload files via URLs to attachment fields
|
|
26
|
+
- ⚡ **Batch Operations** - Create, update, delete up to 10 records at once
|
|
27
|
+
- 👥 **Collaboration Tools** - Manage base collaborators and shared views
|
|
21
28
|
|
|
22
29
|
## 📋 Prerequisites
|
|
23
30
|
|
|
@@ -30,9 +37,11 @@ A Model Context Protocol (MCP) server that enables AI assistants like Claude to
|
|
|
30
37
|
### Step 1: Get Your Airtable Credentials
|
|
31
38
|
|
|
32
39
|
1. **Personal Access Token**: Visit [Airtable Account](https://airtable.com/account) → Create a token with the following scopes:
|
|
33
|
-
- `data.records:read`
|
|
34
|
-
- `data.records:write`
|
|
35
|
-
- `schema.bases:read`
|
|
40
|
+
- `data.records:read` - Read records from tables
|
|
41
|
+
- `data.records:write` - Create, update, delete records
|
|
42
|
+
- `schema.bases:read` - View table schemas
|
|
43
|
+
- `schema.bases:write` - **New in v1.5.0** - Create/modify tables and fields
|
|
44
|
+
- `webhook:manage` - (Optional) For webhook features
|
|
36
45
|
|
|
37
46
|
2. **Base ID**: Open your Airtable base and copy the ID from the URL:
|
|
38
47
|
```
|
|
@@ -119,23 +128,114 @@ After configuration, restart Claude Desktop or your MCP client to load the Airta
|
|
|
119
128
|
|
|
120
129
|
Once configured, you can interact with your Airtable data naturally:
|
|
121
130
|
|
|
131
|
+
### Basic Operations
|
|
122
132
|
```
|
|
123
133
|
"Show me all records in the Projects table"
|
|
124
134
|
"Create a new task with priority 'High' and due date tomorrow"
|
|
125
135
|
"Update the status of task ID rec123 to 'Completed'"
|
|
126
136
|
"Delete all records where status is 'Archived'"
|
|
127
137
|
"What tables are in my base?"
|
|
138
|
+
"Search for records where Status equals 'Active'"
|
|
128
139
|
```
|
|
129
140
|
|
|
130
|
-
|
|
141
|
+
### Webhook Operations (v1.4.0+)
|
|
142
|
+
```
|
|
143
|
+
"Create a webhook for my table that notifies https://my-app.com/webhook"
|
|
144
|
+
"List all active webhooks in my base"
|
|
145
|
+
"Show me the recent webhook payloads"
|
|
146
|
+
"Delete webhook ach123xyz"
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
### Schema Management (v1.5.0+)
|
|
150
|
+
```
|
|
151
|
+
"List all my accessible Airtable bases"
|
|
152
|
+
"Show me the complete schema for this base"
|
|
153
|
+
"Describe the Projects table with all field details"
|
|
154
|
+
"Create a new table called 'Tasks' with Name, Priority, and Due Date fields"
|
|
155
|
+
"Add a Status field to the existing Projects table"
|
|
156
|
+
"What field types are available in Airtable?"
|
|
157
|
+
```
|
|
131
158
|
|
|
159
|
+
### Batch Operations & Attachments (v1.6.0+)
|
|
160
|
+
```
|
|
161
|
+
"Create 5 new records at once in the Tasks table"
|
|
162
|
+
"Update multiple records with new status values"
|
|
163
|
+
"Delete these 3 records in one operation"
|
|
164
|
+
"Attach this image URL to the record's photo field"
|
|
165
|
+
"Who are the collaborators on this base?"
|
|
166
|
+
"Show me all shared views in this base"
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
## 🛠️ Available Tools (33 Total)
|
|
170
|
+
|
|
171
|
+
### 📊 Data Operations (7 tools)
|
|
132
172
|
| Tool | Description |
|
|
133
173
|
|------|-------------|
|
|
134
|
-
| `list_tables` | Get all tables in your base |
|
|
135
|
-
| `list_records` | Query records with optional filtering |
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
174
|
+
| `list_tables` | Get all tables in your base with schema information |
|
|
175
|
+
| `list_records` | Query records with optional filtering and pagination |
|
|
176
|
+
| `get_record` | Retrieve a single record by ID |
|
|
177
|
+
| `create_record` | Add new records to any table |
|
|
178
|
+
| `update_record` | Modify existing record fields |
|
|
138
179
|
| `delete_record` | Remove records from a table |
|
|
180
|
+
| `search_records` | Advanced search with Airtable formulas and sorting |
|
|
181
|
+
|
|
182
|
+
### 🪝 Webhook Management (5 tools)
|
|
183
|
+
| Tool | Description |
|
|
184
|
+
|------|-------------|
|
|
185
|
+
| `list_webhooks` | View all webhooks configured for your base |
|
|
186
|
+
| `create_webhook` | Set up real-time notifications for data changes |
|
|
187
|
+
| `delete_webhook` | Remove webhook configurations |
|
|
188
|
+
| `get_webhook_payloads` | Retrieve webhook notification history |
|
|
189
|
+
| `refresh_webhook` | Extend webhook expiration time |
|
|
190
|
+
|
|
191
|
+
### 🔍 Schema Discovery (6 tools) - **New in v1.5.0**
|
|
192
|
+
| Tool | Description |
|
|
193
|
+
|------|-------------|
|
|
194
|
+
| `list_bases` | List all accessible Airtable bases with permissions |
|
|
195
|
+
| `get_base_schema` | Get complete schema information for any base |
|
|
196
|
+
| `describe_table` | Get detailed table info including all field specifications |
|
|
197
|
+
| `list_field_types` | Reference guide for all available Airtable field types |
|
|
198
|
+
| `get_table_views` | List all views for a specific table with configurations |
|
|
199
|
+
|
|
200
|
+
### 🏗️ Table Management (3 tools) - **New in v1.5.0**
|
|
201
|
+
| Tool | Description |
|
|
202
|
+
|------|-------------|
|
|
203
|
+
| `create_table` | Create new tables with custom field definitions |
|
|
204
|
+
| `update_table` | Modify table names and descriptions |
|
|
205
|
+
| `delete_table` | Remove tables (with safety confirmation required) |
|
|
206
|
+
|
|
207
|
+
### 🔧 Field Management (3 tools) - **New in v1.5.0**
|
|
208
|
+
| Tool | Description |
|
|
209
|
+
|------|-------------|
|
|
210
|
+
| `create_field` | Add new fields to existing tables with all field types |
|
|
211
|
+
| `update_field` | Modify field properties, names, and options |
|
|
212
|
+
| `delete_field` | Remove fields (with safety confirmation required) |
|
|
213
|
+
|
|
214
|
+
### ⚡ Batch Operations (4 tools) - **New in v1.6.0**
|
|
215
|
+
| Tool | Description |
|
|
216
|
+
|------|-------------|
|
|
217
|
+
| `batch_create_records` | Create up to 10 records at once for better performance |
|
|
218
|
+
| `batch_update_records` | Update up to 10 records simultaneously |
|
|
219
|
+
| `batch_delete_records` | Delete up to 10 records in a single operation |
|
|
220
|
+
| `batch_upsert_records` | Update existing or create new records based on key fields |
|
|
221
|
+
|
|
222
|
+
### 📎 Attachment Management (1 tool) - **New in v1.6.0**
|
|
223
|
+
| Tool | Description |
|
|
224
|
+
|------|-------------|
|
|
225
|
+
| `upload_attachment` | Attach files from public URLs to attachment fields |
|
|
226
|
+
|
|
227
|
+
### 👁️ Advanced Views (2 tools) - **New in v1.6.0**
|
|
228
|
+
| Tool | Description |
|
|
229
|
+
|------|-------------|
|
|
230
|
+
| `create_view` | Create new views (grid, form, calendar, etc.) with custom configurations |
|
|
231
|
+
| `get_view_metadata` | Get detailed view information including filters and sorts |
|
|
232
|
+
|
|
233
|
+
### 🏢 Base Management (3 tools) - **New in v1.6.0**
|
|
234
|
+
| Tool | Description |
|
|
235
|
+
|------|-------------|
|
|
236
|
+
| `create_base` | Create new Airtable bases with initial table structures |
|
|
237
|
+
| `list_collaborators` | View base collaborators and their permission levels |
|
|
238
|
+
| `list_shares` | List shared views and their public configurations |
|
|
139
239
|
|
|
140
240
|
## 🔧 Advanced Configuration
|
|
141
241
|
|
|
@@ -185,17 +285,33 @@ If you cloned the repository:
|
|
|
185
285
|
|
|
186
286
|
## 🧪 Testing
|
|
187
287
|
|
|
188
|
-
Run the test suite to verify
|
|
288
|
+
Run the comprehensive test suite to verify all 12 tools:
|
|
189
289
|
|
|
190
290
|
```bash
|
|
191
291
|
# Set environment variables first
|
|
192
292
|
export AIRTABLE_TOKEN=your_token
|
|
193
293
|
export AIRTABLE_BASE_ID=your_base_id
|
|
194
294
|
|
|
195
|
-
#
|
|
196
|
-
|
|
295
|
+
# Start the server
|
|
296
|
+
node airtable_simple.js &
|
|
297
|
+
|
|
298
|
+
# Run comprehensive tests (v1.6.0+)
|
|
299
|
+
./test_v1.6.0_comprehensive.sh
|
|
197
300
|
```
|
|
198
301
|
|
|
302
|
+
The test suite validates:
|
|
303
|
+
- All 33 tools with real API calls
|
|
304
|
+
- Complete CRUD operations
|
|
305
|
+
- Advanced schema management
|
|
306
|
+
- Batch operations (create/update/delete multiple records)
|
|
307
|
+
- Attachment management via URLs
|
|
308
|
+
- Advanced view creation and metadata
|
|
309
|
+
- Base management and collaboration tools
|
|
310
|
+
- Webhook management
|
|
311
|
+
- Error handling and edge cases
|
|
312
|
+
- Security verification
|
|
313
|
+
- 100% test coverage
|
|
314
|
+
|
|
199
315
|
## 🐛 Troubleshooting
|
|
200
316
|
|
|
201
317
|
### "Connection Refused" Error
|
|
@@ -220,10 +336,21 @@ lsof -ti:8010 | xargs kill -9
|
|
|
220
336
|
|
|
221
337
|
## 📚 Documentation
|
|
222
338
|
|
|
339
|
+
- 🎆 [Release Notes v1.6.0](./RELEASE_NOTES_v1.6.0.md) - **Latest major release**
|
|
340
|
+
- [Release Notes v1.5.0](./RELEASE_NOTES_v1.5.0.md)
|
|
341
|
+
- [Release Notes v1.4.0](./RELEASE_NOTES_v1.4.0.md)
|
|
223
342
|
- [Detailed Setup Guide](./CLAUDE_INTEGRATION.md)
|
|
224
343
|
- [Development Guide](./DEVELOPMENT.md)
|
|
225
344
|
- [Security Notice](./SECURITY_NOTICE.md)
|
|
226
|
-
|
|
345
|
+
|
|
346
|
+
## 📦 Version History
|
|
347
|
+
|
|
348
|
+
- **v1.6.0** (2025-08-15) - 🎆 **Major release**: Added batch operations & attachment management (33 total tools)
|
|
349
|
+
- **v1.5.0** (2025-08-15) - Added comprehensive schema management (23 total tools)
|
|
350
|
+
- **v1.4.0** (2025-08-14) - Added webhook support and enhanced CRUD operations (12 tools)
|
|
351
|
+
- **v1.2.4** (2025-08-12) - Security fixes and stability improvements
|
|
352
|
+
- **v1.2.3** (2025-08-11) - Bug fixes and error handling
|
|
353
|
+
- **v1.2.2** (2025-08-10) - Initial stable release
|
|
227
354
|
|
|
228
355
|
## 🤝 Contributing
|
|
229
356
|
|
package/RELEASE_NOTES_v1.2.3.md
CHANGED
|
@@ -0,0 +1,185 @@
|
|
|
1
|
+
# 🚀 Airtable MCP Server v1.5.0 Release Notes
|
|
2
|
+
|
|
3
|
+
**Release Date**: August 15, 2025
|
|
4
|
+
**Major Update**: Enhanced Schema Management & Advanced Features
|
|
5
|
+
|
|
6
|
+
## 🎯 Overview
|
|
7
|
+
|
|
8
|
+
Version 1.5.0 represents a **major expansion** of the Airtable MCP Server, adding comprehensive schema management capabilities inspired by the best features from domdomegg's airtable-mcp-server while maintaining our unique webhook support. This release **doubles** the number of available tools from 12 to **23 tools**.
|
|
9
|
+
|
|
10
|
+
## ✨ New Features
|
|
11
|
+
|
|
12
|
+
### 📊 Schema Discovery Tools (6 New Tools)
|
|
13
|
+
|
|
14
|
+
1. **`list_bases`** - Discover all accessible Airtable bases
|
|
15
|
+
- Lists all bases with permissions
|
|
16
|
+
- Supports pagination with offset parameter
|
|
17
|
+
- Shows base names, IDs, and permission levels
|
|
18
|
+
|
|
19
|
+
2. **`get_base_schema`** - Complete base schema information
|
|
20
|
+
- Detailed table structures and relationships
|
|
21
|
+
- Field definitions with types and options
|
|
22
|
+
- View configurations and metadata
|
|
23
|
+
|
|
24
|
+
3. **`describe_table`** - Enhanced table inspection
|
|
25
|
+
- Comprehensive field information including IDs, types, descriptions
|
|
26
|
+
- View details and configurations
|
|
27
|
+
- Much more detailed than the basic `list_tables`
|
|
28
|
+
|
|
29
|
+
4. **`list_field_types`** - Field type reference
|
|
30
|
+
- Complete documentation of all Airtable field types
|
|
31
|
+
- Includes basic fields (text, number, date) and advanced fields (formulas, lookups)
|
|
32
|
+
- Helpful for understanding what field types are available for creation
|
|
33
|
+
|
|
34
|
+
5. **`get_table_views`** - View management
|
|
35
|
+
- Lists all views for a specific table
|
|
36
|
+
- Shows view types, IDs, and configurations
|
|
37
|
+
- Includes visible field information
|
|
38
|
+
|
|
39
|
+
### 🏗️ Table Management Tools (3 New Tools)
|
|
40
|
+
|
|
41
|
+
6. **`create_table`** - Programmatic table creation
|
|
42
|
+
- Create new tables with custom field definitions
|
|
43
|
+
- Support for all field types with proper validation
|
|
44
|
+
- Optional table descriptions
|
|
45
|
+
|
|
46
|
+
7. **`update_table`** - Table metadata modification
|
|
47
|
+
- Update table names and descriptions
|
|
48
|
+
- Non-destructive metadata changes
|
|
49
|
+
|
|
50
|
+
8. **`delete_table`** - Table removal (with safety checks)
|
|
51
|
+
- Requires explicit confirmation with `confirm=true`
|
|
52
|
+
- Permanently removes table and all data
|
|
53
|
+
- Safety warnings to prevent accidental deletions
|
|
54
|
+
|
|
55
|
+
### 🔧 Field Management Tools (4 New Tools)
|
|
56
|
+
|
|
57
|
+
9. **`create_field`** - Add fields to existing tables
|
|
58
|
+
- Support for all Airtable field types
|
|
59
|
+
- Custom field options and descriptions
|
|
60
|
+
- Validates field types and configurations
|
|
61
|
+
|
|
62
|
+
10. **`update_field`** - Modify existing field properties
|
|
63
|
+
- Update field names, descriptions, and options
|
|
64
|
+
- Change field configurations safely
|
|
65
|
+
|
|
66
|
+
11. **`delete_field`** - Remove fields (with safety checks)
|
|
67
|
+
- Requires explicit confirmation with `confirm=true`
|
|
68
|
+
- Permanently removes field and all data
|
|
69
|
+
- Safety warnings to prevent accidental deletions
|
|
70
|
+
|
|
71
|
+
## 🔄 Enhanced Existing Features
|
|
72
|
+
|
|
73
|
+
- **Improved error handling** for all metadata operations
|
|
74
|
+
- **Better table/field lookup** supporting both names and IDs
|
|
75
|
+
- **Enhanced validation** for destructive operations
|
|
76
|
+
- **Consistent response formatting** across all tools
|
|
77
|
+
|
|
78
|
+
## 📊 Tool Count Summary
|
|
79
|
+
|
|
80
|
+
| Category | v1.4.0 | v1.5.0 | New in v1.5.0 |
|
|
81
|
+
|----------|--------|--------|----------------|
|
|
82
|
+
| **Data Operations** | 7 | 7 | - |
|
|
83
|
+
| **Webhook Management** | 5 | 5 | - |
|
|
84
|
+
| **Schema Management** | 0 | 11 | ✅ 11 new tools |
|
|
85
|
+
| **Total Tools** | **12** | **23** | **+11 tools** |
|
|
86
|
+
|
|
87
|
+
## 🛠️ Technical Improvements
|
|
88
|
+
|
|
89
|
+
### API Enhancements
|
|
90
|
+
- **Metadata API Support**: Full integration with Airtable's metadata API endpoints
|
|
91
|
+
- **Enhanced callAirtableAPI Function**: Already supported metadata endpoints
|
|
92
|
+
- **Improved Error Handling**: Better error messages for schema operations
|
|
93
|
+
|
|
94
|
+
### Security & Safety
|
|
95
|
+
- **Confirmation Required**: Destructive operations require explicit confirmation
|
|
96
|
+
- **Validation Checks**: Proper field type and option validation
|
|
97
|
+
- **Safety Warnings**: Clear warnings for irreversible operations
|
|
98
|
+
|
|
99
|
+
### Authentication
|
|
100
|
+
- **Extended Scope Support**: Now leverages `schema.bases:read` and `schema.bases:write` scopes
|
|
101
|
+
- **Backward Compatibility**: All existing functionality remains unchanged
|
|
102
|
+
|
|
103
|
+
## 📚 New Capabilities
|
|
104
|
+
|
|
105
|
+
### For Users
|
|
106
|
+
- **Complete Base Discovery**: Find and explore all accessible bases
|
|
107
|
+
- **Advanced Schema Inspection**: Understand table and field structures in detail
|
|
108
|
+
- **Programmatic Table Creation**: Build tables through natural language
|
|
109
|
+
- **Dynamic Field Management**: Add, modify, and remove fields as needed
|
|
110
|
+
- **Comprehensive Field Reference**: Quick access to all available field types
|
|
111
|
+
|
|
112
|
+
### For Developers
|
|
113
|
+
- **Full CRUD for Schema**: Complete Create, Read, Update, Delete operations for tables and fields
|
|
114
|
+
- **Metadata-First Approach**: Rich schema information before data operations
|
|
115
|
+
- **Enhanced Automation**: Build complex Airtable structures programmatically
|
|
116
|
+
|
|
117
|
+
## 🚀 Getting Started with v1.5.0
|
|
118
|
+
|
|
119
|
+
### Installation
|
|
120
|
+
```bash
|
|
121
|
+
npm install -g @rashidazarang/airtable-mcp@1.5.0
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Required Token Scopes
|
|
125
|
+
For full v1.5.0 functionality, ensure your Airtable Personal Access Token includes:
|
|
126
|
+
- `data.records:read` - Read records
|
|
127
|
+
- `data.records:write` - Create, update, delete records
|
|
128
|
+
- `schema.bases:read` - View table schemas (**New requirement**)
|
|
129
|
+
- `schema.bases:write` - Create, modify tables and fields (**New requirement**)
|
|
130
|
+
- `webhook:manage` - Webhook operations (optional)
|
|
131
|
+
|
|
132
|
+
### Example Usage
|
|
133
|
+
|
|
134
|
+
```javascript
|
|
135
|
+
// Discover available bases
|
|
136
|
+
"List all my accessible Airtable bases"
|
|
137
|
+
|
|
138
|
+
// Explore a base structure
|
|
139
|
+
"Show me the complete schema for this base"
|
|
140
|
+
|
|
141
|
+
// Create a new table
|
|
142
|
+
"Create a new table called 'Projects' with fields: Name (text), Status (single select with options: Active, Completed, On Hold), and Due Date (date)"
|
|
143
|
+
|
|
144
|
+
// Add a field to existing table
|
|
145
|
+
"Add a 'Priority' field to the Projects table as a single select with options: Low, Medium, High"
|
|
146
|
+
|
|
147
|
+
// Get detailed table information
|
|
148
|
+
"Describe the Projects table with all field details"
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
## 🔧 Breaking Changes
|
|
152
|
+
|
|
153
|
+
**None** - v1.5.0 is fully backward compatible with v1.4.0. All existing tools and functionality remain unchanged.
|
|
154
|
+
|
|
155
|
+
## 🐛 Bug Fixes
|
|
156
|
+
|
|
157
|
+
- **Security**: Fixed clear-text logging of sensitive information (GitHub security alerts)
|
|
158
|
+
- **API Error Handling**: Improved error messages for invalid table/field references
|
|
159
|
+
- **Response Formatting**: Consistent JSON response structure across all tools
|
|
160
|
+
|
|
161
|
+
## 🌟 What's Next
|
|
162
|
+
|
|
163
|
+
- Enhanced search capabilities with field-specific filtering
|
|
164
|
+
- Batch operations for bulk table/field management
|
|
165
|
+
- Advanced view creation and management
|
|
166
|
+
- Performance optimizations for large bases
|
|
167
|
+
|
|
168
|
+
## 📈 Performance & Compatibility
|
|
169
|
+
|
|
170
|
+
- **Node.js**: Requires Node.js 14+
|
|
171
|
+
- **Rate Limits**: Respects Airtable's 5 requests/second limit
|
|
172
|
+
- **Memory Usage**: Optimized for efficient schema operations
|
|
173
|
+
- **Response Times**: Fast metadata operations with caching
|
|
174
|
+
|
|
175
|
+
## 🤝 Community & Support
|
|
176
|
+
|
|
177
|
+
This release incorporates community feedback and feature requests. The v1.5.0 implementation draws inspiration from domdomegg's airtable-mcp-server while maintaining our unique webhook capabilities and enhanced error handling.
|
|
178
|
+
|
|
179
|
+
**GitHub**: https://github.com/rashidazarang/airtable-mcp
|
|
180
|
+
**NPM**: https://www.npmjs.com/package/@rashidazarang/airtable-mcp
|
|
181
|
+
**Issues**: https://github.com/rashidazarang/airtable-mcp/issues
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
🎉 **Thank you for using Airtable MCP Server!** This release makes it the most comprehensive Airtable integration available for AI assistants, combining powerful schema management with robust webhook support.
|
|
@@ -0,0 +1,248 @@
|
|
|
1
|
+
# 🚀 Airtable MCP Server v1.6.0 Release Notes
|
|
2
|
+
|
|
3
|
+
**Release Date**: August 15, 2025
|
|
4
|
+
**Major Update**: Batch Operations, Attachment Management & Advanced Features
|
|
5
|
+
|
|
6
|
+
## 🎯 Overview
|
|
7
|
+
|
|
8
|
+
Version 1.6.0 represents another **major expansion** of the Airtable MCP Server, adding powerful batch operations, attachment management, and advanced base management capabilities. This release increases the total tools from 23 to **33 tools**, providing the most comprehensive Airtable API coverage available for AI assistants.
|
|
9
|
+
|
|
10
|
+
## ✨ New Features (10 New Tools)
|
|
11
|
+
|
|
12
|
+
### ⚡ Batch Operations (4 New Tools)
|
|
13
|
+
|
|
14
|
+
1. **`batch_create_records`** - Create up to 10 records simultaneously
|
|
15
|
+
- Significantly improves performance for bulk data entry
|
|
16
|
+
- Maintains atomicity - all records created or none
|
|
17
|
+
- Proper error handling for validation failures
|
|
18
|
+
|
|
19
|
+
2. **`batch_update_records`** - Update up to 10 records at once
|
|
20
|
+
- Efficient bulk updates with field-level precision
|
|
21
|
+
- Maintains data integrity across operations
|
|
22
|
+
- Returns detailed success/failure information
|
|
23
|
+
|
|
24
|
+
3. **`batch_delete_records`** - Delete up to 10 records in one operation
|
|
25
|
+
- Fast bulk deletion with safety validation
|
|
26
|
+
- Atomic operation ensures consistency
|
|
27
|
+
- Detailed deletion confirmation
|
|
28
|
+
|
|
29
|
+
4. **`batch_upsert_records`** - Smart update-or-create operations
|
|
30
|
+
- Updates existing records or creates new ones based on key fields
|
|
31
|
+
- Intelligent matching using specified key fields
|
|
32
|
+
- Optimizes data synchronization workflows
|
|
33
|
+
|
|
34
|
+
### 📎 Attachment Management (1 New Tool)
|
|
35
|
+
|
|
36
|
+
5. **`upload_attachment`** - Attach files from URLs to records
|
|
37
|
+
- Supports any publicly accessible file URL
|
|
38
|
+
- Automatic file type detection and validation
|
|
39
|
+
- Optional custom filename specification
|
|
40
|
+
- Works with all Airtable-supported file types
|
|
41
|
+
|
|
42
|
+
### 👁️ Advanced View Management (2 New Tools)
|
|
43
|
+
|
|
44
|
+
6. **`create_view`** - Create custom views programmatically
|
|
45
|
+
- Support for all view types: grid, form, calendar, gallery, kanban, timeline, gantt
|
|
46
|
+
- Custom field visibility and ordering
|
|
47
|
+
- Configurable filters and sorts
|
|
48
|
+
- Automated view setup for workflows
|
|
49
|
+
|
|
50
|
+
7. **`get_view_metadata`** - Detailed view configuration retrieval
|
|
51
|
+
- Complete view settings and configurations
|
|
52
|
+
- Filter formulas and sort specifications
|
|
53
|
+
- Field visibility and ordering information
|
|
54
|
+
- Perfect for view replication and analysis
|
|
55
|
+
|
|
56
|
+
### 🏢 Base Management (3 New Tools)
|
|
57
|
+
|
|
58
|
+
8. **`create_base`** - Create new Airtable bases
|
|
59
|
+
- Programmatic base creation with initial table structures
|
|
60
|
+
- Support for workspace organization
|
|
61
|
+
- Batch table and field creation
|
|
62
|
+
- Perfect for template deployment
|
|
63
|
+
|
|
64
|
+
9. **`list_collaborators`** - View base collaboration details
|
|
65
|
+
- Complete collaborator list with permission levels
|
|
66
|
+
- User type identification (user, group, etc.)
|
|
67
|
+
- Permission auditing and management
|
|
68
|
+
- Security compliance support
|
|
69
|
+
|
|
70
|
+
10. **`list_shares`** - Manage shared view configurations
|
|
71
|
+
- Public share URLs and settings
|
|
72
|
+
- Share type and effectiveness status
|
|
73
|
+
- View and table relationship mapping
|
|
74
|
+
- Privacy and access control management
|
|
75
|
+
|
|
76
|
+
## 🔄 Enhanced Existing Features
|
|
77
|
+
|
|
78
|
+
### Performance Improvements
|
|
79
|
+
- **Batch Operations**: Up to 10x faster for bulk operations
|
|
80
|
+
- **Error Handling**: More detailed error messages and validation
|
|
81
|
+
- **API Efficiency**: Reduced API calls through intelligent batching
|
|
82
|
+
|
|
83
|
+
### Security Enhancements
|
|
84
|
+
- **Input Validation**: Enhanced parameter validation for all new tools
|
|
85
|
+
- **Permission Checking**: Better handling of permission-restricted operations
|
|
86
|
+
- **Safe Defaults**: Conservative defaults for destructive operations
|
|
87
|
+
|
|
88
|
+
### User Experience
|
|
89
|
+
- **Better Error Messages**: More descriptive error responses
|
|
90
|
+
- **Consistent Interface**: Uniform parameter naming across all tools
|
|
91
|
+
- **Enhanced Documentation**: Detailed examples and use cases
|
|
92
|
+
|
|
93
|
+
## 📊 Tool Count Progression
|
|
94
|
+
|
|
95
|
+
| Version | Total Tools | New Features |
|
|
96
|
+
|---------|-------------|--------------|
|
|
97
|
+
| **v1.6.0** | **33** | Batch ops, attachments, advanced views, base mgmt |
|
|
98
|
+
| v1.5.0 | 23 | Schema management |
|
|
99
|
+
| v1.4.0 | 12 | Webhooks |
|
|
100
|
+
| v1.2.4 | 5 | Basic CRUD |
|
|
101
|
+
|
|
102
|
+
## 🛠️ Technical Improvements
|
|
103
|
+
|
|
104
|
+
### API Coverage
|
|
105
|
+
- **Complete Airtable API**: Now covers virtually all public Airtable API endpoints
|
|
106
|
+
- **Batch Endpoints**: Full support for Airtable's batch operation limits
|
|
107
|
+
- **Metadata API**: Complete integration with Airtable's metadata capabilities
|
|
108
|
+
|
|
109
|
+
### Architecture
|
|
110
|
+
- **Modular Design**: Clean separation of concerns for each tool category
|
|
111
|
+
- **Error Resilience**: Improved error handling and recovery
|
|
112
|
+
- **Performance Optimized**: Efficient API usage patterns
|
|
113
|
+
|
|
114
|
+
### Compatibility
|
|
115
|
+
- **Backward Compatible**: All v1.5.0 tools unchanged
|
|
116
|
+
- **API Limits**: Respects Airtable's rate limits and batch size restrictions
|
|
117
|
+
- **Token Scopes**: Graceful handling of insufficient permissions
|
|
118
|
+
|
|
119
|
+
## 📚 New Capabilities
|
|
120
|
+
|
|
121
|
+
### For Users
|
|
122
|
+
- **Bulk Data Operations**: Efficiently manage large datasets
|
|
123
|
+
- **File Management**: Easy attachment handling through URLs
|
|
124
|
+
- **Advanced Workflows**: Create complex multi-step processes
|
|
125
|
+
- **Collaboration Insights**: Understand base sharing and permissions
|
|
126
|
+
- **Template Creation**: Programmatically create standardized bases
|
|
127
|
+
|
|
128
|
+
### For Developers
|
|
129
|
+
- **High-Performance Bulk Ops**: Optimize data synchronization
|
|
130
|
+
- **Complete Base Lifecycle**: Full cradle-to-grave base management
|
|
131
|
+
- **Advanced View Control**: Programmatic UI customization
|
|
132
|
+
- **Security Auditing**: Comprehensive permission monitoring
|
|
133
|
+
|
|
134
|
+
## 🚀 Getting Started with v1.6.0
|
|
135
|
+
|
|
136
|
+
### Installation
|
|
137
|
+
```bash
|
|
138
|
+
npm install -g @rashidazarang/airtable-mcp@1.6.0
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
### New Usage Examples
|
|
142
|
+
|
|
143
|
+
#### Batch Operations
|
|
144
|
+
```javascript
|
|
145
|
+
// Create multiple records efficiently
|
|
146
|
+
"Create 5 new project records with these details: [project data]"
|
|
147
|
+
|
|
148
|
+
// Update multiple records at once
|
|
149
|
+
"Update all records where status is 'pending' to 'in progress'"
|
|
150
|
+
|
|
151
|
+
// Delete multiple records
|
|
152
|
+
"Delete these 3 completed tasks: rec123, rec456, rec789"
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
#### Attachment Management
|
|
156
|
+
```javascript
|
|
157
|
+
// Attach files to records
|
|
158
|
+
"Attach this image https://example.com/image.jpg to the product photo field in record rec123"
|
|
159
|
+
|
|
160
|
+
// Batch create with attachments
|
|
161
|
+
"Create a new product record and attach the logo from this URL"
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
#### Advanced Views
|
|
165
|
+
```javascript
|
|
166
|
+
// Create custom views
|
|
167
|
+
"Create a calendar view for the Events table showing only future events"
|
|
168
|
+
|
|
169
|
+
// Analyze view configurations
|
|
170
|
+
"Show me the detailed configuration of the 'Active Projects' view"
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
#### Base Management
|
|
174
|
+
```javascript
|
|
175
|
+
// Create new bases
|
|
176
|
+
"Create a new base called 'Project Tracker' with tables for Projects, Tasks, and Team Members"
|
|
177
|
+
|
|
178
|
+
// Collaboration insights
|
|
179
|
+
"Who has access to this base and what are their permission levels?"
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
## 🔧 Breaking Changes
|
|
183
|
+
|
|
184
|
+
**None** - v1.6.0 maintains full backward compatibility with all previous versions.
|
|
185
|
+
|
|
186
|
+
## 🐛 Bug Fixes
|
|
187
|
+
|
|
188
|
+
- **Batch Size Validation**: Proper enforcement of 10-record limits
|
|
189
|
+
- **Error Message Clarity**: More descriptive API error responses
|
|
190
|
+
- **Permission Handling**: Better graceful degradation for insufficient permissions
|
|
191
|
+
- **URL Validation**: Enhanced validation for attachment URLs
|
|
192
|
+
|
|
193
|
+
## ⚡ Performance Improvements
|
|
194
|
+
|
|
195
|
+
- **Batch Operations**: Up to 10x performance improvement for bulk operations
|
|
196
|
+
- **API Efficiency**: Reduced API calls through intelligent batching
|
|
197
|
+
- **Memory Usage**: Optimized memory usage for large operations
|
|
198
|
+
- **Response Processing**: Faster JSON parsing and response handling
|
|
199
|
+
|
|
200
|
+
## 🌟 What's Next
|
|
201
|
+
|
|
202
|
+
Based on user feedback and Airtable API evolution:
|
|
203
|
+
- Enhanced search and filtering capabilities
|
|
204
|
+
- Advanced automation triggers
|
|
205
|
+
- Real-time collaboration features
|
|
206
|
+
- Performance analytics and monitoring
|
|
207
|
+
- Enterprise-grade security features
|
|
208
|
+
|
|
209
|
+
## 📈 Compatibility & Requirements
|
|
210
|
+
|
|
211
|
+
- **Node.js**: Requires Node.js 14+
|
|
212
|
+
- **Airtable API**: Compatible with latest Airtable API version
|
|
213
|
+
- **Rate Limits**: Respects Airtable's 5 requests/second limit
|
|
214
|
+
- **Token Scopes**: Requires appropriate scopes for advanced features
|
|
215
|
+
|
|
216
|
+
### Required Scopes for Full Functionality
|
|
217
|
+
- `data.records:read` - Read records
|
|
218
|
+
- `data.records:write` - Create, update, delete records
|
|
219
|
+
- `schema.bases:read` - View schemas and metadata
|
|
220
|
+
- `schema.bases:write` - Create/modify tables, fields, views, bases
|
|
221
|
+
- `webhook:manage` - Webhook operations (optional)
|
|
222
|
+
|
|
223
|
+
## 📊 Testing & Quality
|
|
224
|
+
|
|
225
|
+
- **100% Test Coverage**: All 33 tools tested with real API calls
|
|
226
|
+
- **Edge Case Handling**: Comprehensive error condition testing
|
|
227
|
+
- **Performance Testing**: Batch operation efficiency verification
|
|
228
|
+
- **Security Testing**: Permission and validation testing
|
|
229
|
+
|
|
230
|
+
## 🤝 Community Impact
|
|
231
|
+
|
|
232
|
+
v1.6.0 establishes this MCP server as the definitive Airtable integration for AI assistants, providing:
|
|
233
|
+
|
|
234
|
+
- **Most Comprehensive Coverage**: 33 tools covering entire Airtable API
|
|
235
|
+
- **Best Performance**: Intelligent batching and optimization
|
|
236
|
+
- **Enterprise Ready**: Advanced collaboration and security features
|
|
237
|
+
- **Developer Friendly**: Clean, consistent, well-documented interface
|
|
238
|
+
|
|
239
|
+
## 🔗 Resources
|
|
240
|
+
|
|
241
|
+
**GitHub**: https://github.com/rashidazarang/airtable-mcp
|
|
242
|
+
**NPM**: https://www.npmjs.com/package/@rashidazarang/airtable-mcp
|
|
243
|
+
**Issues**: https://github.com/rashidazarang/airtable-mcp/issues
|
|
244
|
+
**Documentation**: https://github.com/rashidazarang/airtable-mcp#readme
|
|
245
|
+
|
|
246
|
+
---
|
|
247
|
+
|
|
248
|
+
🎉 **Thank you for using Airtable MCP Server v1.6.0!** This release represents the culmination of comprehensive Airtable API integration, providing AI assistants with unprecedented access to Airtable's full feature set through natural language interactions.
|