# bitable-mcp

> MCP Server

This repository provides a Model Context Protocol (MCP) server for accessing Lark Bitable, enabling interaction with Bitable tables through predefined tools like listing, describing, and querying data using SQL.

## Overview

- **Category:** Developer Tools
- **Language:** Python
- **Stars:** 2
- **Forks:** 0
- **Owner:** lloydzhou
- **GitHub:** https://github.com/lloydzhou/bitable-mcp
- **Created:** 2025-03-20T01:16:19+00:00
- **Updated:** 2025-03-28T17:25:08+00:00
- **Source:** https://model-context-protocol.com/servers/bitable-lark-mcp-server-data-access

## Setup

## Setup

**One click installation & Configuration (Claude):**
Replace `your_personal_base_token` and `your_app_token` with your actual tokens and run:
```bash
PERSONAL_BASE_TOKEN=your_personal_base_token APP_TOKEN=your_app_token uv run --with uv --with bitable-mcp bitable-mcp-install
```

**Manual installation and configuration:**

1.  Make sure `uvx` is installed.
2.  Add the following to your Claude settings using uvx:
```json
"mcpServers": {
  "bitable-mcp": {
    "command": "uvx",
    "args": ["bitable-mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
}
```
3.  Alternatively, install `bitable-mcp` via pip:
```bash
pip install bitable-mcp
```
4.  Then, modify your Claude settings using pip installation:
```json
"mcpServers": {
  "bitable-mcp": {
    "command": "python",
    "args": ["-m", "bitable_mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
}
```

**Configure for Zed:**

Add the following to your Zed settings.json using uvx:
```json
"context_servers": [
  "bitable-mcp": {
    "command": "uvx",
    "args": ["bitable-mcp"],
    "env": {
        "PERSONAL_BASE_TOKEN": "your-personal-base-token",
        "APP_TOKEN": "your-app-token"
    }
  }
],
```

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

## Tools

## Available Tools

1.  `list_table` (List tables for the current Bitable, returning a JSON-encoded list of table names.)
2.  `describe_table` (Describe a table by its name, returning a JSON-encoded list of columns in the table.)
3.  `read_query` (Execute a SQL query to read data from the tables, returning a JSON-encoded list of query results.)