← Back to Feishu MCP

Install Feishu MCP

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/dinehq/feishu-mcp
cd feishu-mcp

Then follow the repository README for any remaining dependency or build steps.

2

Register it in Claude Code

claude mcp add -e "APP_ID=${APP_ID}" -e "APP_SECRET=${APP_SECRET}" feishu-mcp -- npx tsx /absolute/path/to/src/index.ts -a "<APP_ID>" -s "<APP_SECRET>"

Replace any placeholder paths in the command with the real path on your machine.

Required:APP_IDAPP_SECRET

Environment Variables

Set these before running Feishu MCP.

VariableDescriptionRequired
APP_IDThe App ID from the Feishu Open PlatformYes
APP_SECRETThe App Secret from the Feishu Open PlatformYes

Available Tools (8)

Once configured, Feishu MCP gives your AI agent access to:

get_document_infoRetrieves metadata for a Feishu document.
document_id
read_document_contentReads the content of a Feishu document.
document_id
read_document_blocksReads specific blocks from a Feishu document.
document_id
get_spreadsheet_infoRetrieves metadata for a Feishu spreadsheet.
spreadsheet_token
list_sheetsLists all sheets within a Feishu spreadsheet.
spreadsheet_token
read_spreadsheet_rangeReads data from a specific range in a Feishu spreadsheet.
spreadsheet_tokenrange
list_bitable_tablesLists all tables within a Feishu Bitable (multi-dimensional table).
app_token
read_bitable_recordsReads records from a Feishu Bitable table.
app_tokentable_id

Try It Out

After setup, try these prompts with your AI agent:

Read the content of the Feishu document at https://feishu.cn/docx/docxxxx and summarize the key action items.
List all the sheets available in the spreadsheet with token xxxx.
Fetch the records from the Bitable with app token xxxx and table ID yyyy.
Extract the data from the range A1:D10 in my Feishu spreadsheet.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Node.js 18+ with npm/npx installed
  • APP_ID — The App ID from the Feishu Open Platform
  • APP_SECRET — The App Secret from the Feishu Open Platform
Conare · memory for coding agents

Keep this setup from going cold

Save the docs, env vars, and workflow around Feishu MCP in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup$npx conare@latest