feishu-doc

name	feishu-doc
description	Create, read, edit, search, and delete Lark documents and files.

feishu_doc

Requires authentication — run feishu_auth_init if not yet authenticated.

Quick Reference

Tool	Required	Optional	Returns
feishu_doc_create	—	title, folder_token	document_id
feishu_doc_fetch	document_id	—	content (plain text) + blocks list with block_id, type, text
feishu_doc_append	document_id	text, type, bold, italic, inline_code, done, image_path, callout_emoji, callout_bg	ok
feishu_doc_patch	document_id, block_id, text	bold, italic, inline_code, done	ok
feishu_doc_delete	document_id, block_id	—	ok
feishu_doc_delete_file	file_token	type (docx|file|sheet|bitable, default docx)	{ deleted: true }
feishu_doc_search	query	page_size	list of { token, title, url }

type values for append: paragraph · heading1–heading6 · bullet · ordered · code · quote · todo · callout · equation · image

callout_bg values: 1=LightRed · 2=LightOrange · 3=LightYellow · 4=LightGreen · 5=LightBlue · 6=LightPurple · 7=LightGray

Edit/delete workflow: feishu_doc_fetch → get block_id from blocks list → feishu_doc_patch or feishu_doc_delete

---

Sharing a Doc

After creating, send the URL as a plain text message — Feishu auto-expands it into a doc preview card:

https://feishu.cn/docx/{document_id}

The tenant prefix (tsinghuasigs.feishu.cn etc.) is not required — the short URL works.

---

Scenarios

Read a doc

Get document_id from the URL (last path segment) or feishu_doc_search, then call feishu_doc_fetch.

Delete an entire file

Use feishu_doc_delete_file with the doc's document_id as file_token (and type: "docx" for docs). This permanently deletes the file from Drive — confirm with the user before proceeding.