Feishu MCP Server

Model Context Protocol server for Feishu integration

Remote serverstreamable-http

What is the Feishu MCP server?

Model Context Protocol server for Feishu integration. That is what the feishu mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

  1. 编辑 .env 文件 在项目根目录下找到并用任意文本编辑器打开 .env 文件,填写你的飞书应用凭证: env FEISHU_APP_ID=cli_xxxxx FEISHU_APP_SECRET=xxxxx PORT=3333 FEISHU_AUTH_TYPE=tenant/user FEISHU_ENABLED_MODULES=document,task

Getting it running

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • FEISHU_APP_ID — ✅
  • FEISHU_APP_SECRET — ✅
  • PORT — ❌
  • FEISHU_BASE_URL — ❌
  • FEISHU_AUTH_BASE_URL — ❌
  • FEISHU_PUBLIC_BASE_URL — ❌
  • FEISHU_AUTH_TYPE — ❌
  • FEISHU_SCOPE_VALIDATION — ❌
  • FEISHU_ENABLED_MODULES — ❌
  • FEISHU_USER_KEY — ❌
  • FEISHU_REQUIRE_USER_KEY — ❌
  • FEISHU_ENCRYPTION_KEY — ❌

What it needs from you

Configuration is passed through the environment: FEISHU_APP_ID, FEISHU_APP_SECRET, FEISHU_AUTH_TYPE, FEISHU_ENABLED_MODULES, FEISHU_USER_KEY, FEISHU_BASE_URL, FEISHU_AUTH_BASE_URL, FEISHU_PUBLIC_BASE_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Things to watch

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Feishu.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Feishu's toolset — FEISHU_APP_ID, FEISHU_APP_SECRET, PORT and 11 more — is a fair guide to whether it matches your workflow. It is maintained by yonghuishen; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
FEISHU_APP_ID
FEISHU_APP_SECRET
PORT
FEISHU_BASE_URL
FEISHU_AUTH_BASE_URL
FEISHU_PUBLIC_BASE_URL
FEISHU_AUTH_TYPE
FEISHU_SCOPE_VALIDATION
FEISHU_ENABLED_MODULES
FEISHU_USER_KEY
FEISHU_REQUIRE_USER_KEY
FEISHU_ENCRYPTION_KEY
MCP_BEARER_TOKEN
document文档、文件夹、搜索等

How to install the Feishu MCP server

{
  "mcpServers": {
    "feishu-mcp": {
      "command": "npx",
      "args": ["-y", "feishu-mcp@latest", "--stdio"],
      "env": {
        "FEISHU_APP_ID": "<你的飞书应用ID>",
        "FEISHU_APP_SECRET": "<你的飞书应用密钥>",
        "FEISHU_AUTH_TYPE": "<tenant/user>",
        "FEISHU_ENABLED_MODULES": "document,task",
        "FEISHU_USER_KEY": "<你的用户标识>"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
FEISHU_APP_IDConfiguration value read at startup.Optional
FEISHU_APP_SECRETCredential the server authenticates with.Yes
FEISHU_AUTH_TYPEConfiguration value read at startup.Optional
FEISHU_ENABLED_MODULESConfiguration value read at startup.Optional
FEISHU_USER_KEYCredential the server authenticates with.Yes
FEISHU_BASE_URLEndpoint or connection string the server talks to.Yes
FEISHU_AUTH_BASE_URLEndpoint or connection string the server talks to.Yes
FEISHU_PUBLIC_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Feishu to FEISHU APP ID.
  • Use Feishu to FEISHU APP SECRET.
  • Use Feishu to PORT.

Frequently asked questions

It connects Feishu to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (FEISHU_APP_ID, FEISHU_APP_SECRET, PORT, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Feishu directly.