Feishu Doc

Feishu Document Tool

Single tool feishu_doc with action parameter for all document operations including comment management.

Token Extraction

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

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.

Create + Write (Atomic, Recommended)

{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content..."
}

With folder:

{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content...",
  "folder_token": "fldcnXXX"
}

Creates the document and writes content in one call. Prefer this over separate create + write.

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" }

Creates an empty document (title only).

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" }

List Comments

{ "action": "list_comments", "doc_token": "ABC123def", "page_size": 50 }

Returns all comments for the document. Use page_token for pagination. Comments include is_whole field to distinguish between whole-document comments (true) and block-level comments (false).

Get Single Comment

{ "action": "get_comment", "doc_token": "ABC123def", "comment_id": "comment_xxx" }

Create Comment

{ "action": "create_comment", "doc_token": "ABC123def", "content": "Comment text" }

List Comment Replies

{ "action": "list_comment_replies", "doc_token": "ABC123def", "comment_id": "comment_xxx", "page_size": 50 }

page_size should be a positive integer. If omitted, tool defaults to 50.

Comment Write Scope

Current tool provides documented comment write action create_comment (global comment creation). For replies, use list_comment_replies for retrieval; the reply creation endpoint is not exposed in current SDK surface.

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

For comment operations:

• Read comments: docx:document.comment:read
• Write comments: docx:document.comment (optional, for create_comment)

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.