Feishu Markdown MCP

Feishu Markdown MCP uploads Markdown to Lark or Feishu documents, including image handling and append or replace updates.

Local serverstdioTypeScriptMIT

What is the Feishu Markdown MCP Server?

Feishu Markdown MCP uploads Markdown to Lark or Feishu documents, including image handling and append or replace updates.

Markdown into a cloud document

The server converts a local Markdown file or supplied text into Feishu document blocks. It can render Mermaid diagrams into images, upload local image references and preserve common structures such as code blocks, lists and tables. A separate update tool appends to or replaces an existing document.

Connect with app credentials

The nested MCP package documents an npx stdio launch and the FEISHU_APP_ID and FEISHU_APP_SECRET variables. Configure the app’s document permissions and destination access in Feishu before trying an upload. Local images are resolved relative to the supplied file or configured base path, so an incorrect path can leave a document incomplete.

Choose append or replace explicitly

For an update, verify the target document URL and the intended mode. Replace can overwrite the existing content; append adds to the end. Start with a test document containing a heading, table, code block, Mermaid diagram and local image, then compare the rendered result with the source.

Ownership and large documents

The project describes chunked uploading for large Markdown and optional ownership transfer. Check the owner and folder after creation rather than assuming the document lands in the intended workspace. This is a community integration maintained in the linked repository and uses MIT licensing.

Project documentation

Repository and setup guide

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
upload_markdown_fileUpload a local Markdown file to Feishu.
upload_markdown_textCreate a Feishu document from supplied Markdown.
update_feishu_documentAppend to or replace a Feishu document.

How to install the Feishu Markdown MCP Server

{
  "mcpServers": {
    "feishu-markdown": {
      "command": "npx",
      "args": [
        "-y",
        "feishu-markdown-mcp@latest"
      ],
      "env": {
        "FEISHU_APP_ID": "YOUR_APP_ID",
        "FEISHU_APP_SECRET": "YOUR_APP_SECRET"
      }
    }
  }
}

Configuration

VariableDescriptionRequired
FEISHU_APP_IDFeishu application identifier.Yes
FEISHU_APP_SECRETSecret for the Feishu application.Yes

Frequently asked questions

This is the project maintained in the linked repository. Its documentation defines the supported tools, runtime and access requirements.