@addai/tables-mcp 0.7.0

package/README.md

@@ -0,0 +1,127 @@
+# aitables-mcp
+
+MCP server for [AiTables](https://tables.add.ai) — lets Claude Code (and Claude Desktop) read and manage your AiTables databases, tables, and rows.
+
+## Quick Start
+
+### 1. Get your API key
+
+In AiTables, go to any database → click the dropdown menu → **API Keys** → create a new key with the permissions you need.
+
+### 2. Configure Claude Code
+
+Add to your project's `.mcp.json` (or `~/.claude.json` for global access):
+
+```json
+{
+  "mcpServers": {
+    "aitables": {
+      "command": "npx",
+      "args": ["-y", "aitables-mcp"],
+      "env": {
+        "AITABLES_API_KEY": "ait_user_xxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+### 3. Use it
+
+Just talk to Claude naturally:
+
+- *"What databases do I have?"*
+- *"Show me the columns in my Projects table"*
+- *"Create a task tracker with Status, Priority, and Due Date columns"*
+- *"Add a row: Status = Todo, Priority = High, Due Date = 2026-04-01"*
+- *"Find all rows mentioning 'urgent'"*
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_workspaces` | List accessible workspaces |
+| `list_databases` | List databases (optionally by workspace) |
+| `create_database` | Create a database in a workspace |
+| `get_database` | Get a single database |
+| `update_database` | Rename / re-describe / re-icon a database |
+| `delete_database` | Delete a database and all its contents |
+| `list_tables` | List tables in a database |
+| `get_table_schema` | Get column names, types, and settings |
+| `create_table` | Create a table with columns |
+| `update_table` | Rename / re-describe / re-icon a table |
+| `delete_table` | Delete a table and all its rows |
+| `add_columns` | Add columns to a table |
+| `update_column` | Update column name/options/settings |
+| `delete_column` | Delete a column and its data |
+| `get_row` | Fetch one record by ID — resolves its table automatically when `table_id` is omitted |
+| `list_rows` | Query rows with filters, sorting, pagination |
+| `create_rows` | Create one or more rows |
+| `update_rows` | Update specific cells in rows |
+| `delete_rows` | Delete rows |
+| `search_rows` | Cross-column text search |
+| `export_table` | Export all table data |
+| `list_table_folders` | List folders that group tables in a database |
+| `create_table_folder` | Create a folder for tables (nestable) |
+| `update_table_folder` | Rename / re-icon / re-color a table folder |
+| `delete_table_folder` | Remove a table folder (tables survive) |
+| `move_table_to_folder` | Move a table into a folder (or to root) |
+| `list_database_folders` | List folders that group databases in a workspace |
+| `create_database_folder` | Create a folder for databases |
+| `update_database_folder` | Rename / re-icon / re-color a database folder |
+| `delete_database_folder` | Remove a database folder (databases survive) |
+| `move_database_to_folder` | Move a database into a folder (or to root) |
+| `list_views` | List a table's saved views |
+| `get_view` | Get one view incl. full settings |
+| `create_view` | Create a view (table/kanban/calendar/…) |
+| `update_view` | Update view name/type/settings/public |
+| `delete_view` | Delete a view (not the last one) |
+| `reorder_views` | Reorder a table's views |
+| `list_view_shares` | List public share links for a view |
+| `create_view_share` | Create a public share link |
+| `deactivate_view_share` | Revoke a share link |
+| `get_row_history` | Edit history for a single row |
+| `get_table_history` | Paginated edit history for a table |
+| `upload_file` | Upload a real local file into a FILE column (any size) |
+
+## Smart Column Handling
+
+When you create select/multiselect columns, just provide the option values — colors are auto-assigned:
+
+```
+"Create a Status column with options: Todo, In Progress, Done"
+```
+
+The server generates properly colored options that render correctly in the AiTables UI. This also applies to tags and label columns.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `AITABLES_API_KEY` | Yes | Your AiTables API key (`ait_user_*` or `ait_live_*`) |
+| `AITABLES_API_URL` | No | Override the API base URL (for custom domains) |
+
+## Development
+
+```bash
+cd addai-tables/mcp
+npm install
+npm run build
+npm run dev    # watch mode
+```
+
+For local testing, point your `.mcp.json` to the built output:
+
+```json
+{
+  "mcpServers": {
+    "aitables": {
+      "command": "node",
+      "args": ["path/to/addai-tables/mcp/dist/index.js"],
+      "env": {
+        "AITABLES_API_KEY": "ait_user_xxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```

package/dist/api-client.d.ts

@@ -0,0 +1,12 @@
+import type { ApiResponse } from './types.js';
+export declare class AiTablesClient {
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey: string, baseUrl?: string);
+    private request;
+    get<T = unknown>(path: string, params?: Record<string, string>): Promise<ApiResponse<T>>;
+    post<T = unknown>(path: string, body: unknown): Promise<ApiResponse<T>>;
+    patch<T = unknown>(path: string, body: unknown): Promise<ApiResponse<T>>;
+    delete<T = unknown>(path: string, body?: unknown): Promise<ApiResponse<T>>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;YAK9B,OAAO;IA6Cf,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAI9D,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAI7C,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAI9C,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAGvD"}

package/dist/api-client.js

@@ -0,0 +1,53 @@
+const DEFAULT_BASE_URL = 'https://syhzpqqvrplaqdipcymw.supabase.co/functions/v1/aitables-api/v1';
+export class AiTablesClient {
+    baseUrl;
+    apiKey;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = (baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '');
+    }
+    async request(method, path, options) {
+        let url = `${this.baseUrl}${path}`;
+        if (options?.params) {
+            const searchParams = new URLSearchParams();
+            for (const [key, value] of Object.entries(options.params)) {
+                if (value !== undefined && value !== '') {
+                    searchParams.set(key, value);
+                }
+            }
+            const qs = searchParams.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const headers = {
+            'x-api-key': this.apiKey,
+            'Content-Type': 'application/json',
+        };
+        const fetchOptions = { method, headers };
+        if (options?.body !== undefined) {
+            fetchOptions.body = JSON.stringify(options.body);
+        }
+        const response = await fetch(url, fetchOptions);
+        const json = await response.json();
+        if (!response.ok) {
+            const message = json.error?.message ||
+                json.message ||
+                `API request failed with status ${response.status}`;
+            return { error: { message, code: String(response.status) } };
+        }
+        return json;
+    }
+    async get(path, params) {
+        return this.request('GET', path, { params });
+    }
+    async post(path, body) {
+        return this.request('POST', path, { body });
+    }
+    async patch(path, body) {
+        return this.request('PATCH', path, { body });
+    }
+    async delete(path, body) {
+        return this.request('DELETE', path, { body });
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GACpB,uEAAuE,CAAC;AAE1E,MAAM,OAAO,cAAc;IACjB,OAAO,CAAS;IAChB,MAAM,CAAS;IAEvB,YAAY,MAAc,EAAE,OAAgB;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,OAGC;QAED,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;QAEnC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;YAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;oBACxC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YACD,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,EAAE;gBAAE,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;QAC1B,CAAC;QAED,MAAM,OAAO,GAA2B;YACtC,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,MAAM,YAAY,GAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACtD,IAAI,OAAO,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAoB,CAAC;QAErD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,OAAO,GACX,IAAI,CAAC,KAAK,EAAE,OAAO;gBACnB,IAAI,CAAC,OAAO;gBACZ,kCAAkC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACtD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QAC/D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAc,IAAY,EAAE,MAA+B;QAClE,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAc,IAAY,EAAE,IAAa;QACjD,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK,CAAc,IAAY,EAAE,IAAa;QAClD,OAAO,IAAI,CAAC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,MAAM,CAAc,IAAY,EAAE,IAAc;QACpD,OAAO,IAAI,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/helpers/column-settings.d.ts

@@ -0,0 +1,25 @@
+import type { SelectOption, ColumnDefinition } from '../types.js';
+/**
+ * Assign preset colors to an array of option values, cycling round-robin.
+ */
+export declare function assignColors(values: string[]): SelectOption[];
+/**
+ * Merge new option values with existing options, preserving colors for existing
+ * options and assigning new colors for new ones.
+ */
+export declare function mergeSelectOptions(existingOptions: SelectOption[], newValues: string[]): SelectOption[];
+/**
+ * Enrich a column definition with smart defaults and auto-assigned colors.
+ * This is the core intelligence that makes the MCP smarter than the raw API.
+ */
+export declare function enrichColumnSettings(column: ColumnDefinition): Record<string, unknown>;
+/**
+ * Build the column_settings and column_type for the API request.
+ */
+export declare function buildColumnPayload(column: ColumnDefinition): {
+    name: string;
+    column_type: string;
+    column_settings: Record<string, unknown>;
+    is_required: boolean;
+};
+//# sourceMappingURL=column-settings.d.ts.map

package/dist/helpers/column-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-settings.d.ts","sourceRoot":"","sources":["../../src/helpers/column-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAmBlE;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAM7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,YAAY,EAAE,EAC/B,SAAS,EAAE,MAAM,EAAE,GAClB,YAAY,EAAE,CAoBhB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmCtF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,WAAW,EAAE,OAAO,CAAC;CACtB,CAOA"}

package/dist/helpers/column-settings.js

@@ -0,0 +1,96 @@
+import { getDefaultSettings } from './column-types.js';
+// Preset colors from AiTables (same order as colorUtils.js)
+const PRESET_COLORS = [
+    '#579BFC', // blue
+    '#00C875', // green
+    '#FDAB3D', // yellow
+    '#A25DDC', // purple
+    '#FF642E', // orange
+    '#E2445C', // red
+    '#FF158A', // pink
+    '#00C2E0', // teal
+    '#C4C4C4', // gray
+    '#808080', // dark gray
+    '#7F5347', // brown
+    '#225091', // navy
+];
+/**
+ * Assign preset colors to an array of option values, cycling round-robin.
+ */
+export function assignColors(values) {
+    return values.map((value, index) => ({
+        value,
+        color: PRESET_COLORS[index % PRESET_COLORS.length],
+        active: true,
+    }));
+}
+/**
+ * Merge new option values with existing options, preserving colors for existing
+ * options and assigning new colors for new ones.
+ */
+export function mergeSelectOptions(existingOptions, newValues) {
+    const existingMap = new Map(existingOptions.map((o) => [o.value, o.color]));
+    const usedColors = new Set(existingOptions.map((o) => o.color));
+    let colorIndex = 0;
+    return newValues.map((value) => {
+        if (existingMap.has(value)) {
+            return { value, color: existingMap.get(value), active: true };
+        }
+        // Find next color, preferring unused ones
+        while (usedColors.has(PRESET_COLORS[colorIndex % PRESET_COLORS.length]) &&
+            colorIndex < PRESET_COLORS.length * 2) {
+            colorIndex++;
+        }
+        const color = PRESET_COLORS[colorIndex % PRESET_COLORS.length];
+        colorIndex++;
+        return { value, color, active: true };
+    });
+}
+/**
+ * Enrich a column definition with smart defaults and auto-assigned colors.
+ * This is the core intelligence that makes the MCP smarter than the raw API.
+ */
+export function enrichColumnSettings(column) {
+    const defaults = getDefaultSettings(column.type);
+    const userSettings = column.settings || {};
+    switch (column.type) {
+        case 'select':
+        case 'multiselect':
+            if (column.options && column.options.length > 0) {
+                return { ...defaults, ...userSettings, options: assignColors(column.options) };
+            }
+            return { ...defaults, ...userSettings };
+        case 'tags':
+            if (column.options && column.options.length > 0) {
+                return {
+                    ...defaults,
+                    ...userSettings,
+                    tags: column.options.map((value, i) => ({
+                        value,
+                        color: PRESET_COLORS[i % PRESET_COLORS.length],
+                    })),
+                };
+            }
+            return { ...defaults, ...userSettings };
+        case 'label':
+            if (column.options && column.options.length > 0) {
+                return { ...defaults, ...userSettings, options: assignColors(column.options) };
+            }
+            // Use the 8 preset labels from defaults
+            return { ...defaults, ...userSettings };
+        default:
+            return { ...defaults, ...userSettings };
+    }
+}
+/**
+ * Build the column_settings and column_type for the API request.
+ */
+export function buildColumnPayload(column) {
+    return {
+        name: column.name,
+        column_type: column.type,
+        column_settings: enrichColumnSettings(column),
+        is_required: column.required ?? false,
+    };
+}
+//# sourceMappingURL=column-settings.js.map

package/dist/helpers/column-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-settings.js","sourceRoot":"","sources":["../../src/helpers/column-settings.ts"],"names":[],"mappings":"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"}

package/dist/helpers/column-types.d.ts

@@ -0,0 +1,8 @@
+export declare const COLUMN_TYPES: Record<string, {
+    label: string;
+    defaultSettings: Record<string, unknown>;
+}>;
+export declare function getDefaultSettings(type: string): Record<string, unknown>;
+export declare function isValidColumnType(type: string): boolean;
+export declare const CREATABLE_COLUMN_TYPES: string[];
+//# sourceMappingURL=column-types.d.ts.map

package/dist/helpers/column-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.d.ts","sourceRoot":"","sources":["../../src/helpers/column-types.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAiEpG,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIxE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAGD,eAAO,MAAM,sBAAsB,UASlC,CAAC"}

package/dist/helpers/column-types.js

@@ -0,0 +1,83 @@
+// Column type metadata ported from app/src/utils/columnTypes.js
+// Only includes default settings — no icons or React components
+export const COLUMN_TYPES = {
+    text: { label: 'Text', defaultSettings: { multi: false } },
+    number: { label: 'Number', defaultSettings: { format: 'number', decimals: 0, prefix: '', suffix: '' } },
+    boolean: { label: 'Checkbox', defaultSettings: { style: 'check', color: '#22c55e' } },
+    date: { label: 'Date', defaultSettings: { includeTime: false, format: 'yyyy-MM-dd' } },
+    select: { label: 'Select', defaultSettings: { options: [] } },
+    multiselect: { label: 'Multi-Select', defaultSettings: { options: [] } },
+    tags: { label: 'Tags', defaultSettings: { tags: [] } },
+    label: {
+        label: 'Label',
+        defaultSettings: {
+            options: [
+                { value: 'Label 1', color: '#579BFC' },
+                { value: 'Label 2', color: '#00C875' },
+                { value: 'Label 3', color: '#FDAB3D' },
+                { value: 'Label 4', color: '#A25DDC' },
+                { value: 'Label 5', color: '#FF642E' },
+                { value: 'Label 6', color: '#E2445C' },
+                { value: 'Label 7', color: '#FF158A' },
+                { value: 'Label 8', color: '#00C2E0' },
+            ],
+        },
+    },
+    file: { label: 'File', defaultSettings: { allowedTypes: [], maxSize: 10485760 } },
+    richtext: { label: 'Rich Text', defaultSettings: { multi: false } },
+    html: { label: 'HTML', defaultSettings: { maxPreviewLength: 100 } },
+    url: { label: 'URL', defaultSettings: { displayType: 'link' } },
+    email: { label: 'Email', defaultSettings: {} },
+    phone: { label: 'Phone', defaultSettings: { format: 'international' } },
+    relation: { label: 'Relation', defaultSettings: { targetTableId: null, displayColumn: null } },
+    linked_table: { label: 'Linked Table', defaultSettings: { targetTableId: null, displayColumn: null, relationType: 'single', allowNavigation: true, allowCreation: false } },
+    formula: { label: 'Formula', defaultSettings: { expression: '', resultType: 'text' } },
+    lookup: { label: 'Lookup', defaultSettings: { relationColumn: null, lookupColumn: null } },
+    rollup: { label: 'Rollup', defaultSettings: { relationColumn: null, lookupColumn: null, aggregation: 'count' } },
+    count: { label: 'Count', defaultSettings: { relationColumn: null } },
+    rating: { label: 'Rating', defaultSettings: { maxRating: 5, icon: 'star', color: '#fbbf24' } },
+    progress: { label: 'Progress', defaultSettings: { showIcon: true, showPercentage: true, color: null } },
+    country: { label: 'Country', defaultSettings: {} },
+    world_clock: { label: 'World Clock', defaultSettings: {} },
+    duration: { label: 'Duration', defaultSettings: { format: 'h:mm', unit: 'hours' } },
+    hour: { label: 'Time', defaultSettings: { use24Hour: false } },
+    week: { label: 'Week', defaultSettings: { displayFormat: 'W## YYYY' } },
+    timeline: { label: 'Timeline', defaultSettings: { showDuration: true, showBar: false } },
+    vote: { label: 'Vote', defaultSettings: { color: '#3b82f6' } },
+    checklist: { label: 'Checklist', defaultSettings: {} },
+    color_picker: { label: 'Colour', defaultSettings: {} },
+    people: { label: 'People', defaultSettings: { allowMultiple: true } },
+    team: { label: 'Team', defaultSettings: { allowMultiple: true } },
+    aiboards: { label: 'AiBoards', defaultSettings: { allowMultiple: false } },
+    location: { label: 'Location', defaultSettings: {} },
+    weather: { label: 'Weather', defaultSettings: { sourceLocationColumn: null, units: 'celsius' } },
+    time_tracking: { label: 'Time Tracking', defaultSettings: { targetDurationColumn: null } },
+    autonumber: { label: 'Autonumber', defaultSettings: { prefix: '', suffix: '', startNumber: 1, incrementBy: 1 } },
+    barcode: { label: 'Barcode', defaultSettings: { format: 'qr', displayType: 'both' } },
+    button: { label: 'Button', defaultSettings: { actionType: 'open_url', actionConfig: {}, label: 'Click', icon: null, style: 'primary', confirmMessage: null, url: '' } },
+    form: { label: 'Form', defaultSettings: { formId: null, buttonLabel: 'Fill Form', showProgress: true, style: 'primary' } },
+    ai_column: { label: 'AI Generated', defaultSettings: { aiKeyName: null, promptTemplate: '', systemPrompt: '', model: null, temperature: 0.7, maxTokens: 500, trigger: { type: 'manual_only', watchColumns: [] }, allowRegenerate: true } },
+    creation_log: { label: 'Creation Log', defaultSettings: { dateFormat: 'MMM d, yyyy' } },
+    update_log: { label: 'Update Log', defaultSettings: { dateFormat: 'MMM d, yyyy' } },
+};
+export function getDefaultSettings(type) {
+    const config = COLUMN_TYPES[type];
+    if (!config)
+        return {};
+    return { ...config.defaultSettings };
+}
+export function isValidColumnType(type) {
+    return type in COLUMN_TYPES;
+}
+// Column types that Claude can create via the MCP (excludes system/computed/relational types)
+export const CREATABLE_COLUMN_TYPES = [
+    'text', 'number', 'boolean', 'date',
+    'select', 'multiselect', 'tags', 'label',
+    'file', 'richtext', 'html', 'url', 'email', 'phone',
+    'rating', 'progress', 'country', 'world_clock',
+    'duration', 'hour', 'week', 'timeline',
+    'vote', 'checklist', 'color_picker',
+    'people', 'team', 'aiboards', 'location',
+    'autonumber', 'barcode', 'button',
+];
+//# sourceMappingURL=column-types.js.map

package/dist/helpers/column-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.js","sourceRoot":"","sources":["../../src/helpers/column-types.ts"],"names":[],"mappings":"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"}

package/dist/helpers/errors.d.ts

@@ -0,0 +1,16 @@
+import type { ApiResponse } from '../types.js';
+export declare function formatError(response: ApiResponse): string;
+export declare function mcpError(message: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function mcpResult(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/helpers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/helpers/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAKzD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM;;;;;;EAKvC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO;;;;;EAKtC"}

package/dist/helpers/errors.js

@@ -0,0 +1,19 @@
+export function formatError(response) {
+    if (response.error) {
+        return response.error.message;
+    }
+    return 'Unknown error';
+}
+export function mcpError(message) {
+    return {
+        content: [{ type: 'text', text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+export function mcpResult(data) {
+    const text = typeof data === 'string' ? data : JSON.stringify(data, null, 2);
+    return {
+        content: [{ type: 'text', text }],
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/helpers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/helpers/errors.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;IAChC,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/helpers/mapped-columns.d.ts

@@ -0,0 +1,21 @@
+import type { AiTablesClient } from '../api-client.js';
+import type { Column } from '../types.js';
+export interface ColumnMap {
+    nameToId: Map<string, string>;
+    idToName: Map<string, string>;
+    columns: Column[];
+}
+/**
+ * Fetch columns for a table and build bidirectional name/ID maps.
+ */
+export declare function buildColumnMap(client: AiTablesClient, tableId: string): Promise<ColumnMap>;
+/**
+ * Translate row data from column names to column UUIDs for API writes.
+ * Also normalizes values based on column type (e.g. checklist format).
+ */
+export declare function translateToIds(data: Record<string, unknown>, map: ColumnMap): Record<string, unknown>;
+/**
+ * Translate row data from column UUIDs to column names for display.
+ */
+export declare function translateToNames(data: Record<string, unknown>, map: ColumnMap): Record<string, unknown>;
+//# sourceMappingURL=mapped-columns.d.ts.map

package/dist/helpers/mapped-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapped-columns.d.ts","sourceRoot":"","sources":["../../src/helpers/mapped-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CA2BpB;AA2DD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,SAAS,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,SAAS,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB"}

package/dist/helpers/mapped-columns.js

@@ -0,0 +1,119 @@
+/**
+ * Fetch columns for a table and build bidirectional name/ID maps.
+ */
+export async function buildColumnMap(client, tableId) {
+    const response = await client.get(`/tables/${tableId}/columns`);
+    const columns = response.data || [];
+    const nameToId = new Map();
+    const idToName = new Map();
+    // Track duplicate names to handle collisions
+    const nameCount = new Map();
+    for (const col of columns) {
+        nameCount.set(col.name, (nameCount.get(col.name) || 0) + 1);
+    }
+    for (const col of columns) {
+        const count = nameCount.get(col.name) || 1;
+        if (count > 1) {
+            // Duplicate name — use "Name (column_id)" to disambiguate
+            const disambiguated = `${col.name} (${col.id.slice(0, 8)})`;
+            nameToId.set(disambiguated, col.id);
+            idToName.set(col.id, disambiguated);
+        }
+        else {
+            nameToId.set(col.name, col.id);
+            idToName.set(col.id, col.name);
+        }
+    }
+    return { nameToId, idToName, columns };
+}
+/**
+ * Generate a unique ID for checklist items.
+ */
+function generateId() {
+    return Math.random().toString(36).slice(2, 11) + Date.now().toString(36);
+}
+/**
+ * Normalize a checklist value into the expected format:
+ * [{ id: string, text: string, done: boolean }]
+ *
+ * Accepts:
+ * - Array of strings: ["Buy milk", "Call dentist"]
+ * - Array of objects with text: [{ text: "Buy milk", done: true }]
+ * - Comma-separated string: "Buy milk, Call dentist"
+ * - Already correct format (passed through with ID validation)
+ */
+function normalizeChecklist(value) {
+    if (!value)
+        return [];
+    let items;
+    if (typeof value === 'string') {
+        // Comma-separated string → array of strings
+        items = value.split(',').map((s) => s.trim()).filter(Boolean);
+    }
+    else if (Array.isArray(value)) {
+        items = value;
+    }
+    else {
+        return value; // Unknown format, pass through
+    }
+    return items.map((item) => {
+        if (typeof item === 'string') {
+            return { id: generateId(), text: item, done: false };
+        }
+        if (typeof item === 'object' && item !== null) {
+            const obj = item;
+            return {
+                id: obj.id && typeof obj.id === 'string' ? obj.id : generateId(),
+                text: obj.text ?? obj.label ?? obj.name ?? '',
+                done: Boolean(obj.done ?? obj.checked ?? obj.completed ?? false),
+            };
+        }
+        return { id: generateId(), text: String(item), done: false };
+    });
+}
+/**
+ * Normalize value based on column type.
+ */
+function normalizeForColumnType(value, columnType) {
+    if (columnType === 'checklist') {
+        return normalizeChecklist(value);
+    }
+    return value;
+}
+/**
+ * Translate row data from column names to column UUIDs for API writes.
+ * Also normalizes values based on column type (e.g. checklist format).
+ */
+export function translateToIds(data, map) {
+    // Build a quick lookup: columnId → column_type
+    const typeById = new Map();
+    for (const col of map.columns) {
+        typeById.set(col.id, col.column_type);
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        const columnId = map.nameToId.get(key);
+        if (columnId) {
+            const colType = typeById.get(columnId) || '';
+            result[columnId] = normalizeForColumnType(value, colType);
+        }
+        else {
+            // If it's already a UUID (or unknown key), pass through
+            const colType = typeById.get(key) || '';
+            result[key] = colType ? normalizeForColumnType(value, colType) : value;
+        }
+    }
+    return result;
+}
+/**
+ * Translate row data from column UUIDs to column names for display.
+ */
+export function translateToNames(data, map) {
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        const columnName = map.idToName.get(key);
+        result[columnName || key] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=mapped-columns.js.map

package/dist/helpers/mapped-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapped-columns.js","sourceRoot":"","sources":["../../src/helpers/mapped-columns.ts"],"names":[],"mappings":"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"}