Yuppie MCP Feishu Server

You set up and run the Feishu MCP server to manage multidimensional tables and spreadsheets. It handles automatic token refresh, provides a unified JSON response, and exposes a set of MCP tools for working with Feishu data sources from your MCP client.

How to use

You connect to the Feishu MCP server from your MCP client and call the available tools to manage Feishu multi-dimensional tables (Bitables) and spreadsheets. The server handles token refreshing every two hours and returns consistently structured JSON responses. You can perform create, update, query, and batch operations on Bitable records, as well as create or copy Bitable apps.

How to install

Prerequisites you need before installing: a working Python environment and the UV runtime tool.

Step 1: Clone the Feishu MCP project

git clone <repository-url>
cd yuppie-mcp-feishu

Step 2: Configure environment variables. Copy the template and fill in your Feishu application credentials.

cp .env.example .env

Then edit the .env file to include your Feishu app credentials:

FEISHU_APP_ID=cli_xxxxxxxxxxxxx FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxx

Step 3: Install dependencies using the UV runtime.

uv sync

Step 4: Run tests to verify the setup is working.

uv run python test_mcp.py

Step 5: Run the Feishu MCP server locally.

uv run yuppie-mcp-feishu

Or run as a module if you prefer Python module execution.

Additional setup (Claude Desktop integration)

If you want Claude Desktop to start the Feishu MCP server automatically, add a configuration entry pointing to the runtime. The example below shows how to map the Feishu MCP server to the Python module under a virtual environment and supply credentials.

{
  "mcpServers": {
    "feishu": {
      "command": "/path/to/yuppie-mcp-feishu/.venv/bin/python",
      "args": ["-m", "yuppie_mcp_feishu"],
      "env": {
        "FEISHU_APP_ID": "cli_xxxxxxxxxxxxx",
        "FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Note: Replace /path/to/yuppie-mcp-feishu with your actual project path.

Feishu MCP tools (capabilities)

The server exposes a set of tools to manage Feishu Bitable apps and bitable records. Use the tool names below from your MCP client to perform actions.

Project structure

Key files and modules are organized to separate configuration, Feishu client management, exceptions, and specialized tools.

Technical notes

Supported language: Python. MCP framework: UV runtime for orchestration. Feishu SDK: Python integration via the Feishu Open Platform libraries.

Troubleshooting and notes

If you encounter authentication issues, re-check FEISHU_APP_ID and FEISHU_APP_SECRET values in your environment. Ensure tokens refresh automatically every 2 hours as designed. When testing, verify that your environment has network access to Feishu and that the MCP server has permission to access the Feishu APIs.

Available tools

create_bitable_app

Create a new Feishu multi-dimensional table (Bitable) application and return the app information in JSON format.

copy_bitable_app

Copy an existing Feishu Bitable app by app token, and provide the new app information.

create_bitable_record

Create a single record in a specified Bitable table for a given app token and table ID.

update_bitable_record

Update a single Bitable record’s fields using app token, table ID, and record ID.

search_bitable_records

Query Bitable records with optional pagination and filters for a given app token and table ID.

batch_create_bitable_records

Batch create up to 1000 Bitable records for a table within an app.

batch_update_bitable_records

Batch update up to 1000 Bitable records with new field values.

batch_get_bitable_records

Batch fetch up to 100 Bitable records by their IDs.

batch_delete_bitable_records

Batch delete specified Bitable records by their IDs.