wecom-meeting-query

用途

wecom-meeting-query 是企业微信会议查询技能，用于查询企业微信中的会议信息。当用户需要"查看会议"、"查询会议列表"、"会议详情"、"什么时候开会"、"有哪些会议"、"查找会议"时触发。所有操作通过调用 wecom_mcp 这个 MCP tool 完成。

前置条件

首次调用 wecom_mcp 前，必须按 wecom-preflight 技能执行前置条件检查，确保工具已加入白名单。

主要能力

查询会议列表：按用户和时间范围查询会议 ID 列表。限制为当日及前后 30 天，上限 100 个。
获取会议详情：通过会议 ID 查询完整会议信息。
按关键词查找会议：结合会议列表与详情查询，按标题关键词匹配目标会议。

使用方式

查看可用命令列表：使用 wecom_mcp tool 调用 wecom_mcp list meeting。

执行指定命令：使用 wecom_mcp tool 调用 wecom_mcp call meeting <tool_name> '<json_params>'。

查询会议列表（list_user_meetings）

执行命令：

使用 wecom_mcp tool 调用 wecom_mcp call meeting list_user_meetings '{"begin_datetime": "2026-03-01 00:00", "end_datetime": "2026-03-31 23:59", "limit": 100}'

入参说明：

begin_datetime（string，否）：查询起始时间，格式 YYYY-MM-DD HH:mm
end_datetime（string，否）：查询结束时间，格式 YYYY-MM-DD HH:mm
cursor（string，否）：分页游标，用于获取下一页数据
limit（integer，否）：每页返回条数，最大 100

限制：时间范围仅支持当日及前后 30 天。

返回参数：

{
  "errcode": 0,
  "errmsg": "ok",
  "next_cursor": "分页游标字符串, 为空表示无更多",
  "meetingid_list": ["会议ID_1", "会议ID_2"]
}

meetingid_list（array）：会议 ID 列表
next_cursor（string）：下一页游标，为空表示无更多数据

获取会议详情（get_meeting_info）

执行命令：

使用 wecom_mcp tool 调用 wecom_mcp call meeting get_meeting_info '{"meetingid": "<会议id>"}'

入参说明：

meetingid（string，是）：会议 ID，通过 list_user_meetings 获取
meeting_code（string，否）：会议号码
sub_meetingid（string，否）：子会议 ID

返回参数包含 errcode、errmsg、creator_userid、admin_userid、title、meeting_start_datetime、meeting_duration、description、location、main_department、status、meeting_type、attendees、settings、meeting_code、meeting_link、has_vote、has_more_sub_meeting、remain_sub_meetings、current_sub_meetingid、guests、reminders、sub_meetings、sub_repeat_list 等字段。

关键返回字段：

creator_userid（string）：创建者 userid，与 admin_userid 有且仅返回一个
admin_userid（string）：会议管理 userid，与 creator_userid 有且仅返回一个
title（string）：会议标题
meeting_start_datetime（string）：会议开始时间
meeting_duration（integer）：会议时长（秒）
main_department（integer）：创建者所属主部门
status（integer）：会议状态（1: 待开始, 2: 会议中, 3: 已结束, 4: 已取消, 5: 已过期）
meeting_type（integer）：会议类型（0: 一次性会议, 1: 周期性会议, 2: 微信专属会议, 3: Rooms 投屏会议, 5: 个人会议号会议, 6: 网络研讨会）
meeting_code（string）：会议号码
meeting_link（string）：会议链接
attendees.member（array）：内部参与者列表
attendees.member[].status（integer）：与会状态（1: 已参与, 2: 未参与）
attendees.tmp_external_user（array）：外部参与者（临时 ID）
attendees.tmp_external_user[].status（integer）：与会状态（1: 已参与, 2: 未参与）
guests（array）：外部嘉宾列表，每项含 area、phone_number、guest_name
current_sub_meetingid（string）：当前子会议 ID
settings.ring_users（object）：响铃用户列表
settings.need_password（boolean）：是否需要密码（只读字段）
settings.enable_doc_upload_permission（boolean）：是否允许成员上传文档
settings.hosts（object）：主持人列表
settings.current_hosts（object）：当前主持人列表
settings.co_hosts（object）：联席主持人列表
reminders（object）：周期性配置
has_vote（boolean）：是否有投票（仅会议创建人和主持人有权限查询）
has_more_sub_meeting（integer）：是否还有更多子会议特例（0: 无更多, 1: 有更多）
remain_sub_meetings（integer）：剩余子会议场数
sub_meetings（array）：子会议列表
sub_meetings[].status（integer）：子会议状态（0: 默认/存在, 1: 已删除）
sub_meetings[].repeat_id（string）：周期性会议分段 ID，用于关联子会议所属分段
sub_repeat_list（array）：周期性会议分段信息，修改周期性会议某一场后可能产生不同分段，各分段有不同重复规则

典型工作流

工作流 1：查询会议列表

示例：用户说"帮我查一下本周有哪些会议"。

步骤：

确定时间范围：根据当前日期计算本周的起止时间。
查询会议 ID 列表：使用 wecom_mcp tool 调用 wecom_mcp call meeting list_user_meetings '{"begin_datetime": "2026-03-16 00:00", "end_datetime": "2026-03-22 23:59", "limit": 100}'
逐个查询会议详情（对返回的每个 meetingid）：使用 wecom_mcp tool 调用 wecom_mcp call meeting get_meeting_info '{"meetingid": "<会议id1>"}'，对每个会议 ID 重复调用。
汇总展示会议列表，包含标题、时间、参与者等信息。

分页处理：如果 next_cursor 不为空，使用 cursor 参数继续拉取下一页。

工作流 2：获取会议详情

示例：用户说"帮我看下技术方案评审会议的详情"。

步骤：

定位会议：先通过会议列表查询找到目标会议的 meetingid（按关键词匹配）。
查询详情：使用 wecom_mcp tool 调用 wecom_mcp call meeting get_meeting_info '{"meetingid": "<target_meetingid>"}'
展示结果，包含会议号、标题、时间、时长、地点、描述、创建者、参与者、会议链接等。

工作流 3：根据关键词查找会议

示例：用户说"技术评审会议是什么时候?"。

查询策略：

确定查询范围：默认查当日前后 30 天（接口限制范围）。
拉取会议列表：使用 wecom_mcp tool 调用 wecom_mcp call meeting list_user_meetings '{"begin_datetime": "2026-02-15 00:00", "end_datetime": "2026-04-16 23:59", "limit": 100}'
逐个查询详情并匹配标题关键词。
找到匹配后停止查询，展示结果，包含会议号、标题、时间、时长、地点、参与者、会议链接等。

未找到处理：告知用户在前后 30 天范围内未找到匹配会议，请确认会议名称。

适用场景

用户需要查看某段时间内的会议安排
用户需要了解某场会议的详细信息
用户需要按名称或关键词查找特定会议
用户询问什么时候开会、有哪些会议

限制

时间格式统一使用 YYYY-MM-DD HH:mm 格式。
会议列表时间范围限制：仅支持查询当日及前后 30 天内的会议。
查询详情需两步：先通过 list_user_meetings 获取会议 ID 列表，再通过 get_meeting_info 逐个获取详情。
首次调用 wecom_mcp 前必须按 wecom-preflight 技能执行前置条件检查。
has_vote 字段仅会议创建人和主持人有权限查询。