teable-mcp-full

MCP server for Teable — works with self-hosted and cloud instances.

Compatible with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP client.

Setup

1. Get your Personal Access Token

In Teable: Settings → Account → Personal Access Token → Create

2. Add to Claude Desktop config

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "teable": {
      "command": "npx",
      "args": ["-y", "teable-mcp-full"],
      "env": {
        "TEABLE_TOKEN": "<your-personal-access-token>",
        "TEABLE_ENDPOINT": "<https://your-teable-url>"
      }
    }
  }
}

For cloud: TEABLE_ENDPOINT = https://app.teable.io For self-hosted: set your instance URL (e.g. https://teable.yourcompany.com)

Restart Claude Desktop after saving.

Available tools

| Tool | Description | |------|-------------| | teable_get_spaces | List all spaces | | teable_get_bases | List bases in a space | | teable_get_tables | List tables in a base | | teable_get_fields | Get field schema for a table | | teable_get_records | Query records (with pagination) | | teable_create_records | Create one or multiple records | | teable_update_records | Update records by ID | | teable_delete_records | Delete records by ID | | teable_sql_query | Run SQL query |

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | TEABLE_TOKEN | ✅ | Personal Access Token | | TEABLE_ENDPOINT | ✅ | Teable URL (e.g. https://app.teable.io) |

License

MIT