teable-mcp

Full-CRUD MCP server for Teable — zero build step, npx-ready.

Quick Start

1. Get your API token

Teable → Settings → Personal Access Token → Create token

Enable scopes: Read space, base, table, record, view, field · Write record, field, table, view

2. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "teable": {
      "command": "npx",
      "args": ["-y", "teable-mcp"],
      "env": {
        "TEABLE_API_KEY": "your_token_here"
      }
    }
  }
}

Restart Claude Desktop. Done.

Self-hosted Teable

Add TEABLE_BASE_URL to point at your instance:

{
  "mcpServers": {
    "teable": {
      "command": "npx",
      "args": ["-y", "teable-mcp"],
      "env": {
        "TEABLE_API_KEY": "your_token_here",
        "TEABLE_BASE_URL": "https://your-teable.example.com/api"
      }
    }
  }
}

Why this over the community server?

| Feature | ltphat2204 | teable-mcp | |---|---|---| | Setup | Clone → build → configure path | npx teable-mcp | | Create records | ❌ | ✅ | | Update records | ❌ | ✅ | | Delete records | ❌ | ✅ | | Batch operations | ❌ | ✅ (up to 2000 records) | | Schema management | ❌ | ✅ | | Table management | ❌ | ✅ | | View management | ❌ | ✅ | | Published on npm | ❌ | ✅ |

Tools (23 total)

Discovery

| Tool | Description | |---|---| | list_spaces | All spaces the API key can access | | list_bases | All bases in a space | | list_tables | All tables in a base | | get_table_schema | Full field definitions — call before writing records | | list_views | All views in a table |

Records — Read

| Tool | Description | |---|---| | get_records | Fetch with filter, sort, search, pagination, field projection | | get_record | Single record by ID | | get_record_history | Full audit trail for a record |

Records — Write

| Tool | Description | |---|---| | create_records | Create 1–2000 records, with typecast | | update_record | PATCH a single record (only changed fields) | | update_records | Batch update multiple records | | delete_records | Delete one or more records by ID |

Schema Management

| Tool | Description | |---|---| | create_field | Add a field (text, number, select, date, checkbox, formula…) | | update_field | Rename or update field options | | delete_field | Remove a field permanently |

Base Management

| Tool | Description | |---|---| | create_base | Create a new base in a space | | delete_base | Delete a base permanently |

Table Management

| Tool | Description | |---|---| | create_table | Create a new table, optionally with initial fields | | update_table | Rename or update a table | | delete_table | Move table to trash (recoverable) |

View Management

| Tool | Description | |---|---| | create_view | Create grid, gallery, kanban, calendar, gantt, or form view | | update_view | Rename or update a view | | delete_view | Remove a view |

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | TEABLE_API_KEY | ✅ | — | Personal Access Token from Teable settings | | TEABLE_BASE_URL | ❌ | https://app.teable.io/api | Override for self-hosted instances |

Debugging with MCP Inspector

TEABLE_API_KEY=your_token npx @modelcontextprotocol/inspector node dist/index.js

Local Development

git clone https://github.com/imperol3/teable-mcp
cd teable-mcp
npm install
npm run build

TEABLE_API_KEY=your_token node dist/index.js

License

MIT