feishu-report

name	feishu-report
description	Deliver content to Feishu (飞书) in the appropriate format: plain text for quick replies, card messages for structured info, Feishu Docs for long reports, calendar events for meetings, and tasks for action items. Use whenever the output should go to a Feishu user or group.
metadata	{"miqi":{"emoji":"💬","requires":{"mcp":["feishu-mcp"]}}}

Feishu Report

Choose the right delivery format. Default to the simplest that fits.

Tool naming. All Feishu tools below are exposed at runtime as mcp_feishu-mcp_<name> (e.g. mcp_feishu-mcp_send_message). The bare names in the table are shown for readability — always use the prefixed form when calling. Length limits, file-permission workflow and group-@mention behavior are documented in TOOLS.md.

Format Decision

Content type	Tool to use
Short reply / notification (< 500 chars)	mcp_feishu-mcp_send_message or mcp_feishu-mcp_reply_message
Structured info (table, status, multi-section)	mcp_feishu-mcp_send_card_message
Long report / research briefing (> 1000 chars)	mcp_feishu-mcp_create_document + mcp_feishu-mcp_write_document_markdown → mcp_feishu-mcp_get_share_link → mcp_feishu-mcp_send_message
Meeting / event	mcp_feishu-mcp_create_calendar_event (+mcp_feishu-mcp_add_event_attendees)
Action item / to-do	mcp_feishu-mcp_create_task (+mcp_feishu-mcp_assign_task, mcp_feishu-mcp_add_task_to_list)

---

1. Plain Text Message

mcp_feishu-mcp_send_message(
    receive_id_type="chat_id",   # or "open_id" / "email"
    receive_id="<chat_id>",
    content="Your briefing is ready.",
)

For @mention someone: use mcp_feishu-mcp_build_text_with_at to construct content.

---

2. Card Message (Structured)

Use for research briefings, status reports, job results — anything with sections or a table.

mcp_feishu-mcp_send_card_message(
    receive_id_type="chat_id",
    receive_id="<chat_id>",
    card_content='<JSON card>'   # use mcp_feishu-mcp_build_interactive_card() helper or hand-craft
)

Basic card structure (Feishu Card JSON):

{
  "config": {"wide_screen_mode": true},
  "elements": [
    {"tag": "div", "text": {"tag": "lark_md", "content": "**Title**\n\nContent here"}},
    {"tag": "hr"},
    {"tag": "div", "text": {"tag": "lark_md", "content": "References:\n[1] ..."}}
  ]
}

---

3. Feishu Doc (Long Reports)

Best for reports > 1000 characters or content that may be shared / revisited.

# Step 1: create doc (optionally inside a folder)
doc = mcp_feishu-mcp_create_document(title="Quantum Computing Briefing — 2026-03-19")

# Step 2: write Markdown content
mcp_feishu-mcp_write_document_markdown(
    document_id=doc["document_id"],
    markdown="# Quantum Computing Briefing\n\n## Key Findings\n..."
)

# Step 3: get shareable link and notify
link = mcp_feishu-mcp_get_share_link(document_id=doc["document_id"])
mcp_feishu-mcp_send_message(receive_id_type="chat_id", receive_id="<chat_id>",
             content=f"今日量子计算简报已生成：{link['link']}")

After creating any document, grant the current group full_access permission — see the file-upload workflow in TOOLS.md. write_document_markdown accepts standard Markdown: headings, bold, italic, lists, code blocks, tables.

---

4. Calendar Event

cal = mcp_feishu-mcp_get_or_create_group_calendar()
event = mcp_feishu-mcp_create_calendar_event(
    calendar_id=cal["calendar_id"],
    summary="Team Sync",
    start_time="2026-03-20T10:00:00+08:00",
    end_time="2026-03-20T11:00:00+08:00",
    description="Weekly sync"
)
mcp_feishu-mcp_add_event_attendees(calendar_id=cal["calendar_id"],
                    event_id=event["event_id"],
                    attendee_ids=["<open_id1>", "<open_id2>"])

---

5. Task

task = mcp_feishu-mcp_create_task(
    title="Review draft report",
    notes="See shared doc: <link>",
    due="2026-03-21T18:00:00+08:00"
)
mcp_feishu-mcp_assign_task(task_id=task["task_id"], member_ids=["<open_id>"])

---

Resolving User Identities

When you only have a name (not open_id), use:

mcp_feishu-mcp_resolve_users_by_name(name="Alice")      # fuzzy match → returns open_id list
mcp_feishu-mcp_get_chat_members(chat_id="<chat_id>")    # list everyone in a group