Bitable MCP Server

This MCP server provides access to Lark Bitable through the Model Context Protocol. It allows users to interact with Bitable tables using predefined

Local serverstdioPython

What is the Bitable MCP MCP server?

Bitable MCP MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. This MCP server provides access to Lark Bitable through the Model Context Protocol. It allows users to interact with Bitable tables using predefined tools.

Setting it up

Installation goes through your MCP client rather than a global install: point it at @smithery/cli on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What the assistant can call

Once Bitable MCP is connected, these are the calls the assistant has available:

  • list_table — List tables for the current Bitable
  • Returns — A JSON-encoded list of table names
  • describe_table — Describe a table by its name
  • Parameters — - name (str): The name of the table to describe
  • read_query — Execute a SQL query to read data from the tables
  • Claude — To install and configure the server, use the following command: bash PERSONAL_BASE_TOKEN=your_personal_base_token APP_TOKEN=your_app_token uv run
  • Cursor — The Cursor tool exposed by this server
  • Windsurf — The Windsurf tool exposed by this server

Configuration and credentials

You will need 2 environment variables: PERSONAL_BASE_TOKEN, APP_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the bitable mcp mcp server does with a few real requests.

Choosing this one

This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Bitable MCP's toolset — list_table, Returns, describe_table and 5 more — is a fair guide to whether it matches your workflow. It is maintained by lloydzhou; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Bitable MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
list_tableList tables for the current Bitable.
ReturnsA JSON-encoded list of table names.
describe_tableDescribe a table by its name.
Parameters- name (str): The name of the table to describe.
read_queryExecute a SQL query to read data from the tables.
ClaudeTo install and configure the server, use the following command: bash PERSONAL_BASE_TOKEN=your_personal_base_token APP_TOKEN=your_app_token uv run --with uv --with bitable-mcp bitable-mcp-install Replace your_personal_bas
CursorThe Cursor tool exposed by this server.
WindsurfThe Windsurf tool exposed by this server.

How to install the Bitable MCP MCP server

2) Modify your Claude settings

```json
"mcpServers": {
  "bitable-mcp": {
    "command": "python",
    "args": ["-m", "bitable_mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
PERSONAL_BASE_TOKENCredential the server authenticates with.Yes
APP_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Bitable MCP to list table.
  • Use Bitable MCP to Returns.
  • Use Bitable MCP to describe table.

Frequently asked questions

It connects Bitable MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (list_table, Returns, describe_table, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Bitable MCP directly.