Feishu MCP Remote Service for Openclaw

A remote service bridge that enables AI agents to interact with the Feishu ecosystem through the Model Context Protocol (MCP) via HTTP APIs.

jirboy
v1.0.0
Apr 17, 2026
0
708
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install feishu-mcp-remote

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install feishu-mcp-remote using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Feishu MCP Remote Service?

The Feishu MCP Remote skill is a high-performance integration designed for developers who need to connect their AI agents with the Feishu (Lark) collaboration suite. By utilizing the Model Context Protocol over a standard HTTP interface, this skill allows for deep integration with cloud documents, user directories, and file management systems without the need for local deployment.

As part of the Openclaw Skills ecosystem, this tool simplifies the complexity of enterprise API management. It provides a standardized way for LLM-powered agents to perform actions such as creating documents, searching for team members, and managing comments, all while maintaining strict security through User and Tenant authentication tokens.

Feishu MCP Remote Service Use Cases

  • Automatically generating and updating project status reports directly within Lark cloud documents.
  • Empowering AI assistants to find contact information for internal employees using natural language.
  • Reading and synthesizing information from multiple Feishu documents to create consolidated summaries.
  • Managing document feedback loops by programmatically reading and adding comments to specific doc blocks.

How Feishu MCP Remote Service Works

  1. The AI agent or client initiates a session by sending an initialize request to the Feishu MCP endpoint with valid UAT or TAT credentials.
  2. The system validates permissions and returns the protocol version and session parameters.
  3. The agent calls the tools/list method to discover available capabilities such as search-doc or create-doc.
  4. Specific tasks are executed via the tools/call method, passing the required arguments in a JSON-RPC 2.0 format.
  5. The remote service processes the request via the Feishu Open Platform and returns the structured result or error code to the agent.

Feishu MCP Remote Service Setup

To use this integration within the Openclaw Skills framework, follow these steps:

  1. Create a custom app on the Feishu Open Platform and obtain your App ID and App Secret.
  2. Apply for the necessary API permissions (e.g., docx:document:readonly, contact:user:search).
  3. Generate an access token (TAT for app-level or UAT for user-level access).
  4. Configure your client to point to the remote endpoint: https://mcp.feishu.cn/mcp.
# Example of setting up the required headers for a request
export FEISHU_TAT_TOKEN="t-gxxxxxxxxxxxxxx"
export ALLOWED_TOOLS="create-doc,fetch-doc"

Feishu MCP Remote Service Data Schema & Taxonomy

The skill communicates using JSON-RPC 2.0. Below is the organization of typical data exchange:

Component Type Description
jsonrpc String Must be "2.0"
method String The MCP action (initialize, tools/list, tools/call)
params Object Contains the tool name and specific arguments (e.g., docID, content)
headers Object Includes authentication (X-Lark-MCP-TAT/UAT) and allowed tool filters
result Object The output of the tool execution, including text content or file metadata

Feishu MCP Remote Service Advanced Features

  • Multi-Identity Support: Seamlessly switch between User Access Tokens (UAT) and Tenant Access Tokens (TAT) based on the workflow requirements.
  • Security Filtering: Use the X-Lark-MCP-Allowed-Tools header to restrict an agent's access to a specific subset of available tools.
  • Rich Document Operations: Supports complex block-level updates and multi-format document searching (doc/docx).
  • Comprehensive Error Handling: Detailed JSON-RPC error codes ranging from authentication failures to rate-limiting (429) triggers.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*