Bitable

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

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "lloydzhou-bitable-mcp": {
      "command": "uvx",
      "args": [
        "bitable-mcp"
      ],
      "env": {
        "APP_TOKEN": "YOUR_APP_TOKEN",
        "PERSONAL_BASE_TOKEN": "YOUR_PERSONAL_BASE_TOKEN"
      }
    }
  }
}

The Bitable MCP Server lets you access Lark Bitable data through the Model Context Protocol. It exposes tools to list Bitable tables, describe table schemas, and query data, enabling you to interact with your tables directly from an MCP client.

How to use

To work with this MCP server, you connect from your MCP client and use the provided tools to inspect and query your Bitable data. You can list available tables, inspect a specific table to see its columns, and run read queries to retrieve data. These capabilities let you compose natural-language prompts that fetch or summarize table content without leaving your chat or assistant interface.

How to install

Prerequisites: you need Node.js and npm, or Python with pip, depending on how you choose to run the server. You also need your Bitable access tokens to authenticate.

Option A — Run via uvx (preferred runtime for MCP servers) 1) Install the server command 2) Start with your tokens in the environment 3) Use the MCP client to connect to bitable-mcp

# Option A: uvx-based runtime
# Start the MCP server for Bitable mcp via uvx
# Replace tokens with your actual values
PERSONAL_BASE_TOKEN=your-personal-base-token APP_TOKEN=your-app-token uvx run --with uv --with bitable-mcp bitable-mcp-install

If you prefer a Python-based runtime instead, you can use the Python module for the MCP server.

# Option B: Python-based runtime
# Start the MCP server for Bitable mcp via Python module
PERSONAL_BASE_TOKEN=your-personal-base-token APP_TOKEN=your-app-token uv run --with uv --with bitable-mcp bitable-mcp-install
`

Alternative installation methods shown here assume you are configuring the MCP server inside your Claude or Zed environment. If you are using uvx, add the configuration in your MCP settings to point to the server as bitable-mcp with the necessary tokens.

Configuration snippets

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

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

Available tools

list_table

List all Bitable tables accessible to your tokens. Returns a JSON-encoded list of table names.

describe_table

Describe a specific Bitable table by name. Returns a JSON-encoded list of the table's columns.

read_query

Execute a SQL-like query against the Bitable tables to read data. Returns a JSON-encoded list of results.