Feishu Doc

Feishu Document Tool

Single tool feishu_doc with action parameter for all document operations.

Token Extraction

From URL https://xxx.feishu.cn/docx/ABC123def → doc_token = ABC123def

Actions

Read Document

{ "action": "read", "doc_token": "ABC123def" }

Returns: title, plain text content, block statistics. Check hint field - if present, structured content (tables, images) exists that requires list_blocks.

Write Document (Replace All)

{ "action": "write", "doc_token": "ABC123def", "content": "# Title\n\nMarkdown content..." }

Replaces entire document with markdown content. Supports: headings, lists, code blocks, quotes, links, images (![](url) auto-uploaded), bold/italic/strikethrough.

Limitation: Markdown tables are NOT supported.

Append Content

{ "action": "append", "doc_token": "ABC123def", "content": "Additional content" }

Appends markdown to end of document.

Create Document

{ "action": "create", "title": "New Document" }

With folder:

{ "action": "create", "title": "New Document", "folder_token": "fldcnXXX" }

List Blocks

{ "action": "list_blocks", "doc_token": "ABC123def" }

Returns full block data including tables, images. Use this to read structured content.

Get Single Block

{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }

Update Block Text

{
  "action": "update_block",
  "doc_token": "ABC123def",
  "block_id": "doxcnXXX",
  "content": "New text"
}

Delete Block

{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }

Reading Workflow

1. Start with action: "read" - get plain text + statistics 2. Check block_types in response for Table, Image, Code, etc. 3. If structured content exists, use action: "list_blocks" for full data

Configuration

channels:
  feishu:
    tools:
      doc: true # default: true

Note: feishu_wiki depends on this tool - wiki page content is read/written via feishu_doc.

Permissions

Required: docx:document, docx:document:readonly, docx:document.block:convert, drive:drive

Feishu Block Types Reference

Complete reference for Feishu document block types. Use with feishu_doc_list_blocks, feishu_doc_update_block, and feishu_doc_delete_block.

Block Type Table

Editing Guidelines

Text-based blocks (2-17, 19)

Update text content using feishu_doc_update_block:

{
  "doc_token": "ABC123",
  "block_id": "block_xxx",
  "content": "New text content"
}

Image blocks (27)

Images cannot be updated directly via update_block. Use feishu_doc_write or feishu_doc_append with markdown to add new images.

Table blocks (31)

Important: Table blocks CANNOT be created via the documentBlockChildren.create API (error 1770029). This affects feishu_doc_write and feishu_doc_append - markdown tables will be skipped with a warning.

Tables can only be read (via list_blocks) and individual cells (type 32) can be updated, but new tables cannot be inserted programmatically via markdown.

Container blocks (24, 25, 35)

Grid and QuoteContainer are layout containers. Edit their child blocks instead.

Common Patterns

Replace specific paragraph

1. feishu_doc_list_blocks - find the block_id 2. feishu_doc_update_block - update its content

Insert content at specific location

Currently, the API only supports appending to document end. For insertion at specific positions, consider:

1. Read existing content 2. Delete affected blocks 3. Rewrite with new content in desired order

Delete multiple blocks

Blocks must be deleted one at a time. Delete child blocks before parent containers.