@rashidazarang/airtable-mcp 1.6.0 → 2.1.1

package/RELEASE_NOTES_v1.5.0.md

@@ -1,185 +0,0 @@
-# 🚀 Airtable MCP Server v1.5.0 Release Notes
-
-**Release Date**: August 15, 2025  
-**Major Update**: Enhanced Schema Management & Advanced Features
-
-## 🎯 Overview
-
-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**.
-
-## ✨ New Features
-
-### 📊 Schema Discovery Tools (6 New Tools)
-
-1. **`list_bases`** - Discover all accessible Airtable bases
-   - Lists all bases with permissions
-   - Supports pagination with offset parameter
-   - Shows base names, IDs, and permission levels
-
-2. **`get_base_schema`** - Complete base schema information
-   - Detailed table structures and relationships
-   - Field definitions with types and options
-   - View configurations and metadata
-
-3. **`describe_table`** - Enhanced table inspection
-   - Comprehensive field information including IDs, types, descriptions
-   - View details and configurations
-   - Much more detailed than the basic `list_tables`
-
-4. **`list_field_types`** - Field type reference
-   - Complete documentation of all Airtable field types
-   - Includes basic fields (text, number, date) and advanced fields (formulas, lookups)
-   - Helpful for understanding what field types are available for creation
-
-5. **`get_table_views`** - View management
-   - Lists all views for a specific table
-   - Shows view types, IDs, and configurations
-   - Includes visible field information
-
-### 🏗️ Table Management Tools (3 New Tools)
-
-6. **`create_table`** - Programmatic table creation
-   - Create new tables with custom field definitions
-   - Support for all field types with proper validation
-   - Optional table descriptions
-
-7. **`update_table`** - Table metadata modification
-   - Update table names and descriptions
-   - Non-destructive metadata changes
-
-8. **`delete_table`** - Table removal (with safety checks)
-   - Requires explicit confirmation with `confirm=true`
-   - Permanently removes table and all data
-   - Safety warnings to prevent accidental deletions
-
-### 🔧 Field Management Tools (4 New Tools)
-
-9. **`create_field`** - Add fields to existing tables
-   - Support for all Airtable field types
-   - Custom field options and descriptions
-   - Validates field types and configurations
-
-10. **`update_field`** - Modify existing field properties
-    - Update field names, descriptions, and options
-    - Change field configurations safely
-
-11. **`delete_field`** - Remove fields (with safety checks)
-    - Requires explicit confirmation with `confirm=true`
-    - Permanently removes field and all data
-    - Safety warnings to prevent accidental deletions
-
-## 🔄 Enhanced Existing Features
-
-- **Improved error handling** for all metadata operations
-- **Better table/field lookup** supporting both names and IDs
-- **Enhanced validation** for destructive operations
-- **Consistent response formatting** across all tools
-
-## 📊 Tool Count Summary
-
-| Category | v1.4.0 | v1.5.0 | New in v1.5.0 |
-|----------|--------|--------|----------------|
-| **Data Operations** | 7 | 7 | - |
-| **Webhook Management** | 5 | 5 | - |
-| **Schema Management** | 0 | 11 | ✅ 11 new tools |
-| **Total Tools** | **12** | **23** | **+11 tools** |
-
-## 🛠️ Technical Improvements
-
-### API Enhancements
-- **Metadata API Support**: Full integration with Airtable's metadata API endpoints
-- **Enhanced callAirtableAPI Function**: Already supported metadata endpoints
-- **Improved Error Handling**: Better error messages for schema operations
-
-### Security & Safety
-- **Confirmation Required**: Destructive operations require explicit confirmation
-- **Validation Checks**: Proper field type and option validation
-- **Safety Warnings**: Clear warnings for irreversible operations
-
-### Authentication
-- **Extended Scope Support**: Now leverages `schema.bases:read` and `schema.bases:write` scopes
-- **Backward Compatibility**: All existing functionality remains unchanged
-
-## 📚 New Capabilities
-
-### For Users
-- **Complete Base Discovery**: Find and explore all accessible bases
-- **Advanced Schema Inspection**: Understand table and field structures in detail
-- **Programmatic Table Creation**: Build tables through natural language
-- **Dynamic Field Management**: Add, modify, and remove fields as needed
-- **Comprehensive Field Reference**: Quick access to all available field types
-
-### For Developers
-- **Full CRUD for Schema**: Complete Create, Read, Update, Delete operations for tables and fields
-- **Metadata-First Approach**: Rich schema information before data operations
-- **Enhanced Automation**: Build complex Airtable structures programmatically
-
-## 🚀 Getting Started with v1.5.0
-
-### Installation
-```bash
-npm install -g @rashidazarang/airtable-mcp@1.5.0
-```
-
-### Required Token Scopes
-For full v1.5.0 functionality, ensure your Airtable Personal Access Token includes:
-- `data.records:read` - Read records
-- `data.records:write` - Create, update, delete records  
-- `schema.bases:read` - View table schemas (**New requirement**)
-- `schema.bases:write` - Create, modify tables and fields (**New requirement**)
-- `webhook:manage` - Webhook operations (optional)
-
-### Example Usage
-
-```javascript
-// Discover available bases
-"List all my accessible Airtable bases"
-
-// Explore a base structure  
-"Show me the complete schema for this base"
-
-// Create a new table
-"Create a new table called 'Projects' with fields: Name (text), Status (single select with options: Active, Completed, On Hold), and Due Date (date)"
-
-// Add a field to existing table
-"Add a 'Priority' field to the Projects table as a single select with options: Low, Medium, High"
-
-// Get detailed table information
-"Describe the Projects table with all field details"
-```
-
-## 🔧 Breaking Changes
-
-**None** - v1.5.0 is fully backward compatible with v1.4.0. All existing tools and functionality remain unchanged.
-
-## 🐛 Bug Fixes
-
-- **Security**: Fixed clear-text logging of sensitive information (GitHub security alerts)
-- **API Error Handling**: Improved error messages for invalid table/field references
-- **Response Formatting**: Consistent JSON response structure across all tools
-
-## 🌟 What's Next
-
-- Enhanced search capabilities with field-specific filtering
-- Batch operations for bulk table/field management
-- Advanced view creation and management
-- Performance optimizations for large bases
-
-## 📈 Performance & Compatibility
-
-- **Node.js**: Requires Node.js 14+
-- **Rate Limits**: Respects Airtable's 5 requests/second limit
-- **Memory Usage**: Optimized for efficient schema operations
-- **Response Times**: Fast metadata operations with caching
-
-## 🤝 Community & Support
-
-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.
-
-**GitHub**: https://github.com/rashidazarang/airtable-mcp  
-**NPM**: https://www.npmjs.com/package/@rashidazarang/airtable-mcp  
-**Issues**: https://github.com/rashidazarang/airtable-mcp/issues  
-
----
-
-🎉 **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.

package/RELEASE_NOTES_v1.6.0.md

@@ -1,248 +0,0 @@
-# 🚀 Airtable MCP Server v1.6.0 Release Notes
-
-**Release Date**: August 15, 2025  
-**Major Update**: Batch Operations, Attachment Management & Advanced Features
-
-## 🎯 Overview
-
-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.
-
-## ✨ New Features (10 New Tools)
-
-### ⚡ Batch Operations (4 New Tools)
-
-1. **`batch_create_records`** - Create up to 10 records simultaneously
-   - Significantly improves performance for bulk data entry
-   - Maintains atomicity - all records created or none
-   - Proper error handling for validation failures
-
-2. **`batch_update_records`** - Update up to 10 records at once
-   - Efficient bulk updates with field-level precision
-   - Maintains data integrity across operations
-   - Returns detailed success/failure information
-
-3. **`batch_delete_records`** - Delete up to 10 records in one operation
-   - Fast bulk deletion with safety validation
-   - Atomic operation ensures consistency
-   - Detailed deletion confirmation
-
-4. **`batch_upsert_records`** - Smart update-or-create operations
-   - Updates existing records or creates new ones based on key fields
-   - Intelligent matching using specified key fields
-   - Optimizes data synchronization workflows
-
-### 📎 Attachment Management (1 New Tool)
-
-5. **`upload_attachment`** - Attach files from URLs to records
-   - Supports any publicly accessible file URL
-   - Automatic file type detection and validation
-   - Optional custom filename specification
-   - Works with all Airtable-supported file types
-
-### 👁️ Advanced View Management (2 New Tools)
-
-6. **`create_view`** - Create custom views programmatically
-   - Support for all view types: grid, form, calendar, gallery, kanban, timeline, gantt
-   - Custom field visibility and ordering
-   - Configurable filters and sorts
-   - Automated view setup for workflows
-
-7. **`get_view_metadata`** - Detailed view configuration retrieval
-   - Complete view settings and configurations
-   - Filter formulas and sort specifications
-   - Field visibility and ordering information
-   - Perfect for view replication and analysis
-
-### 🏢 Base Management (3 New Tools)
-
-8. **`create_base`** - Create new Airtable bases
-   - Programmatic base creation with initial table structures
-   - Support for workspace organization
-   - Batch table and field creation
-   - Perfect for template deployment
-
-9. **`list_collaborators`** - View base collaboration details
-   - Complete collaborator list with permission levels
-   - User type identification (user, group, etc.)
-   - Permission auditing and management
-   - Security compliance support
-
-10. **`list_shares`** - Manage shared view configurations
-    - Public share URLs and settings
-    - Share type and effectiveness status
-    - View and table relationship mapping
-    - Privacy and access control management
-
-## 🔄 Enhanced Existing Features
-
-### Performance Improvements
-- **Batch Operations**: Up to 10x faster for bulk operations
-- **Error Handling**: More detailed error messages and validation
-- **API Efficiency**: Reduced API calls through intelligent batching
-
-### Security Enhancements
-- **Input Validation**: Enhanced parameter validation for all new tools
-- **Permission Checking**: Better handling of permission-restricted operations
-- **Safe Defaults**: Conservative defaults for destructive operations
-
-### User Experience
-- **Better Error Messages**: More descriptive error responses
-- **Consistent Interface**: Uniform parameter naming across all tools
-- **Enhanced Documentation**: Detailed examples and use cases
-
-## 📊 Tool Count Progression
-
-| Version | Total Tools | New Features |
-|---------|-------------|--------------|
-| **v1.6.0** | **33** | Batch ops, attachments, advanced views, base mgmt |
-| v1.5.0 | 23 | Schema management |
-| v1.4.0 | 12 | Webhooks |
-| v1.2.4 | 5 | Basic CRUD |
-
-## 🛠️ Technical Improvements
-
-### API Coverage
-- **Complete Airtable API**: Now covers virtually all public Airtable API endpoints
-- **Batch Endpoints**: Full support for Airtable's batch operation limits
-- **Metadata API**: Complete integration with Airtable's metadata capabilities
-
-### Architecture
-- **Modular Design**: Clean separation of concerns for each tool category
-- **Error Resilience**: Improved error handling and recovery
-- **Performance Optimized**: Efficient API usage patterns
-
-### Compatibility
-- **Backward Compatible**: All v1.5.0 tools unchanged
-- **API Limits**: Respects Airtable's rate limits and batch size restrictions
-- **Token Scopes**: Graceful handling of insufficient permissions
-
-## 📚 New Capabilities
-
-### For Users
-- **Bulk Data Operations**: Efficiently manage large datasets
-- **File Management**: Easy attachment handling through URLs
-- **Advanced Workflows**: Create complex multi-step processes
-- **Collaboration Insights**: Understand base sharing and permissions
-- **Template Creation**: Programmatically create standardized bases
-
-### For Developers
-- **High-Performance Bulk Ops**: Optimize data synchronization
-- **Complete Base Lifecycle**: Full cradle-to-grave base management
-- **Advanced View Control**: Programmatic UI customization
-- **Security Auditing**: Comprehensive permission monitoring
-
-## 🚀 Getting Started with v1.6.0
-
-### Installation
-```bash
-npm install -g @rashidazarang/airtable-mcp@1.6.0
-```
-
-### New Usage Examples
-
-#### Batch Operations
-```javascript
-// Create multiple records efficiently
-"Create 5 new project records with these details: [project data]"
-
-// Update multiple records at once
-"Update all records where status is 'pending' to 'in progress'"
-
-// Delete multiple records
-"Delete these 3 completed tasks: rec123, rec456, rec789"
-```
-
-#### Attachment Management
-```javascript
-// Attach files to records
-"Attach this image https://example.com/image.jpg to the product photo field in record rec123"
-
-// Batch create with attachments
-"Create a new product record and attach the logo from this URL"
-```
-
-#### Advanced Views
-```javascript
-// Create custom views
-"Create a calendar view for the Events table showing only future events"
-
-// Analyze view configurations
-"Show me the detailed configuration of the 'Active Projects' view"
-```
-
-#### Base Management
-```javascript
-// Create new bases
-"Create a new base called 'Project Tracker' with tables for Projects, Tasks, and Team Members"
-
-// Collaboration insights
-"Who has access to this base and what are their permission levels?"
-```
-
-## 🔧 Breaking Changes
-
-**None** - v1.6.0 maintains full backward compatibility with all previous versions.
-
-## 🐛 Bug Fixes
-
-- **Batch Size Validation**: Proper enforcement of 10-record limits
-- **Error Message Clarity**: More descriptive API error responses
-- **Permission Handling**: Better graceful degradation for insufficient permissions
-- **URL Validation**: Enhanced validation for attachment URLs
-
-## ⚡ Performance Improvements
-
-- **Batch Operations**: Up to 10x performance improvement for bulk operations
-- **API Efficiency**: Reduced API calls through intelligent batching
-- **Memory Usage**: Optimized memory usage for large operations
-- **Response Processing**: Faster JSON parsing and response handling
-
-## 🌟 What's Next
-
-Based on user feedback and Airtable API evolution:
-- Enhanced search and filtering capabilities
-- Advanced automation triggers
-- Real-time collaboration features
-- Performance analytics and monitoring
-- Enterprise-grade security features
-
-## 📈 Compatibility & Requirements
-
-- **Node.js**: Requires Node.js 14+
-- **Airtable API**: Compatible with latest Airtable API version
-- **Rate Limits**: Respects Airtable's 5 requests/second limit
-- **Token Scopes**: Requires appropriate scopes for advanced features
-
-### Required Scopes for Full Functionality
-- `data.records:read` - Read records
-- `data.records:write` - Create, update, delete records
-- `schema.bases:read` - View schemas and metadata
-- `schema.bases:write` - Create/modify tables, fields, views, bases
-- `webhook:manage` - Webhook operations (optional)
-
-## 📊 Testing & Quality
-
-- **100% Test Coverage**: All 33 tools tested with real API calls
-- **Edge Case Handling**: Comprehensive error condition testing
-- **Performance Testing**: Batch operation efficiency verification
-- **Security Testing**: Permission and validation testing
-
-## 🤝 Community Impact
-
-v1.6.0 establishes this MCP server as the definitive Airtable integration for AI assistants, providing:
-
-- **Most Comprehensive Coverage**: 33 tools covering entire Airtable API
-- **Best Performance**: Intelligent batching and optimization
-- **Enterprise Ready**: Advanced collaboration and security features
-- **Developer Friendly**: Clean, consistent, well-documented interface
-
-## 🔗 Resources
-
-**GitHub**: https://github.com/rashidazarang/airtable-mcp  
-**NPM**: https://www.npmjs.com/package/@rashidazarang/airtable-mcp  
-**Issues**: https://github.com/rashidazarang/airtable-mcp/issues  
-**Documentation**: https://github.com/rashidazarang/airtable-mcp#readme
-
----
-
-🎉 **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.

package/SECURITY_NOTICE.md

@@ -1,40 +0,0 @@
-# Security Notice
-
-## Important: API Token Rotation Required
-
-If you have been using or testing this repository before January 2025, please note that hardcoded API tokens were previously included in test files. These have been removed and replaced with environment variable requirements.
-
-### Actions Required:
-
-1. **If you used the exposed tokens**: 
-   - These tokens have been revoked and are no longer valid
-   - You must use your own Airtable API credentials
-
-2. **For all users**:
-   - Never commit API tokens to version control
-   - Always use environment variables or secure configuration files
-   - Add `.env` to your `.gitignore` file
-
-### Secure Configuration
-
-Set your credentials using environment variables:
-
-```bash
-export AIRTABLE_TOKEN="your_personal_token_here"
-export AIRTABLE_BASE_ID="your_base_id_here"
-```
-
-Or create a `.env` file (never commit this):
-
-```env
-AIRTABLE_TOKEN=your_personal_token_here
-AIRTABLE_BASE_ID=your_base_id_here
-```
-
-### Reporting Security Issues
-
-If you discover any security vulnerabilities, please report them to:
-- Open an issue on GitHub (without including sensitive details)
-- Contact the maintainer directly for sensitive information
-
-Thank you for helping keep this project secure.