@addai/tables-mcp 0.7.0

package/dist/tools/views.js

@@ -0,0 +1,169 @@
+import { z } from 'zod';
+import { mcpError, mcpResult } from '../helpers/errors.js';
+const VIEW_TYPES = [
+    'table',
+    'calendar',
+    'gallery',
+    'kanban',
+    'timeline',
+    'list',
+    'gantt',
+    'form',
+    'dashboard',
+    'document',
+];
+// Views are saved presentations of a table's rows — each carries a view_type
+// (table/kanban/calendar/…) and a view_settings JSON blob holding that view's
+// filters, sorts, grouping, hidden columns, kanban stack column, etc. A table
+// always has at least one view (you cannot delete the last one).
+export function registerViewTools(server, client) {
+    // ── list_views ──
+    server.tool('list_views', 'List all saved views on a table, ordered as they appear in the UI. Each view has an id, name, view_type, and view_settings (filters/sorts/grouping/etc.).', {
+        table_id: z.string().uuid().describe('The table whose views you want to list'),
+    }, async ({ table_id }) => {
+        const res = await client.get(`/tables/${table_id}/views`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── get_view ──
+    server.tool('get_view', 'Get a single view including its full view_settings (filters, sorts, grouping, hidden columns, etc.).', {
+        table_id: z.string().uuid().describe('The table the view belongs to'),
+        view_id: z.string().uuid().describe('The view ID'),
+    }, async ({ table_id, view_id }) => {
+        const res = await client.get(`/tables/${table_id}/views/${view_id}`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── create_view ──
+    server.tool('create_view', 'Create a new view on a table. Defaults to a table (grid) view. view_settings is a free-form JSON blob whose shape depends on view_type — e.g. kanban needs a groupBy column, calendar needs a date column. Inspect an existing view of the same type with get_view first to learn the expected settings shape.', {
+        table_id: z.string().uuid().describe('The table to create the view in'),
+        name: z.string().min(1).describe('View name'),
+        view_type: z
+            .enum(VIEW_TYPES)
+            .optional()
+            .describe('View type. Defaults to "table". One of: ' + VIEW_TYPES.join(', ')),
+        view_settings: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('View-type-specific settings (filters, sorts, grouping, etc.). Omit for defaults.'),
+    }, async ({ table_id, name, view_type, view_settings }) => {
+        const body = { name };
+        if (view_type)
+            body.view_type = view_type;
+        if (view_settings)
+            body.view_settings = view_settings;
+        const res = await client.post(`/tables/${table_id}/views`, body);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── update_view ──
+    server.tool('update_view', 'Update a view\'s name, type, settings, or public flag. Only the fields you pass change. NOTE: view_settings REPLACES the entire settings object — call get_view first and merge if you only want to change part of it.', {
+        table_id: z.string().uuid().describe('The table the view belongs to'),
+        view_id: z.string().uuid().describe('The view to update'),
+        name: z.string().min(1).optional().describe('New view name'),
+        view_type: z.enum(VIEW_TYPES).optional().describe('Change the view type'),
+        view_settings: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Replacement settings object (filters/sorts/grouping/etc.) — replaces the whole blob'),
+        is_public: z.boolean().optional().describe('Whether the view is publicly accessible'),
+    }, async ({ table_id, view_id, name, view_type, view_settings, is_public }) => {
+        const body = {};
+        if (name !== undefined)
+            body.name = name;
+        if (view_type !== undefined)
+            body.view_type = view_type;
+        if (view_settings !== undefined)
+            body.view_settings = view_settings;
+        if (is_public !== undefined)
+            body.is_public = is_public;
+        if (Object.keys(body).length === 0) {
+            return mcpError('Nothing to update — provide name, view_type, view_settings, or is_public');
+        }
+        const res = await client.patch(`/tables/${table_id}/views/${view_id}`, body);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── delete_view ──
+    server.tool('delete_view', 'Delete a view from a table. A table must keep at least one view, so deleting the last remaining view fails.', {
+        table_id: z.string().uuid().describe('The table the view belongs to'),
+        view_id: z.string().uuid().describe('The view to delete'),
+    }, async ({ table_id, view_id }) => {
+        const res = await client.delete(`/tables/${table_id}/views/${view_id}`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'View deleted' });
+    });
+    // ── reorder_views ──
+    server.tool('reorder_views', 'Reorder a table\'s views. Pass the complete list of view ids in the desired order — the array index becomes the new display order.', {
+        table_id: z.string().uuid().describe('The table whose views to reorder'),
+        view_ids: z
+            .array(z.string().uuid())
+            .min(1)
+            .describe('All view ids in the desired order (first = leftmost)'),
+    }, async ({ table_id, view_ids }) => {
+        const res = await client.post(`/tables/${table_id}/views/reorder`, { view_ids });
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Views reordered' });
+    });
+    // ── list_view_shares ──
+    server.tool('list_view_shares', 'List the public share links created for a view, including each link\'s token, permission level, active state, and expiry.', {
+        table_id: z.string().uuid().describe('The table the view belongs to'),
+        view_id: z.string().uuid().describe('The view whose shares to list'),
+    }, async ({ table_id, view_id }) => {
+        const res = await client.get(`/tables/${table_id}/views/${view_id}/shares`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── create_view_share ──
+    server.tool('create_view_share', 'Create a public share link for a view. Returns a share_token that can be used to access the view without logging in. Defaults to view-only access.', {
+        table_id: z.string().uuid().describe('The table the view belongs to'),
+        view_id: z.string().uuid().describe('The view to share'),
+        permission_level: z
+            .enum(['view', 'edit'])
+            .optional()
+            .describe('"view" (read-only, default) or "edit" (allow changes via the link)'),
+        expires_at: z
+            .string()
+            .optional()
+            .describe('ISO 8601 timestamp when the link should stop working. Omit for no expiry.'),
+        allowed_domains: z
+            .array(z.string())
+            .optional()
+            .describe('Restrict access to viewers from these email domains'),
+        settings: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Optional extra share settings'),
+    }, async ({ table_id, view_id, permission_level, expires_at, allowed_domains, settings }) => {
+        const body = {};
+        if (permission_level)
+            body.permission_level = permission_level;
+        if (expires_at)
+            body.expires_at = expires_at;
+        if (allowed_domains)
+            body.allowed_domains = allowed_domains;
+        if (settings)
+            body.settings = settings;
+        const res = await client.post(`/tables/${table_id}/views/${view_id}/shares`, body);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult(res.data);
+    });
+    // ── deactivate_view_share ──
+    server.tool('deactivate_view_share', 'Deactivate (revoke) a view share link by its share id so it can no longer be used. This is a soft delete — the link stops working immediately.', {
+        share_id: z.string().uuid().describe('The share id to deactivate (from list_view_shares)'),
+    }, async ({ share_id }) => {
+        const res = await client.delete(`/shares/${share_id}`);
+        if (res.error)
+            return mcpError(res.error.message);
+        return mcpResult({ message: 'Share deactivated' });
+    });
+}
+//# sourceMappingURL=views.js.map

package/dist/tools/views.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,76 @@
+export interface ApiResponse<T = unknown> {
+    data?: T;
+    error?: {
+        message: string;
+        code?: string;
+    };
+    pagination?: {
+        page: number;
+        page_size: number;
+        total_count: number;
+        total_pages: number;
+    };
+    count?: number;
+    success?: boolean;
+    message?: string;
+}
+export interface Workspace {
+    id: string;
+    name: string;
+    slug: string;
+    created_date: string;
+}
+export interface Database {
+    id: string;
+    name: string;
+    description: string | null;
+    icon: string | null;
+    workspace_id: string;
+    created_date: string;
+    updated_date: string;
+}
+export interface Table {
+    id: string;
+    database_id: string;
+    name: string;
+    description: string | null;
+    icon: string | null;
+    created_date: string;
+    updated_date: string;
+    columns?: Column[];
+}
+export interface Column {
+    id: string;
+    name: string;
+    column_type: string;
+    column_settings: Record<string, unknown>;
+    is_required: boolean;
+    column_order: number;
+}
+export interface Row {
+    id: string;
+    data: Record<string, unknown>;
+    created_by: string;
+    created_date: string;
+    updated_date: string;
+    parent_id: string | null;
+    sort_order: number | null;
+}
+export interface SelectOption {
+    value: string;
+    color: string;
+    active: boolean;
+}
+export interface ColumnDefinition {
+    name: string;
+    type: string;
+    options?: string[];
+    required?: boolean;
+    settings?: Record<string, unknown>;
+}
+export interface RowFilter {
+    column_id: string;
+    operator: string;
+    value: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Shared types for the AiTables MCP server
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2CAA2C"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@addai/tables-mcp",
+  "version": "0.7.0",
+  "description": "MCP server for AiTables — lets Claude Code read and manage your AiTables databases",
+  "type": "module",
+  "bin": {
+    "tables-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "aitables",
+    "airtable",
+    "database",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}