microsoft/channel-digest

Channel Digest

Produce a consolidated summary of activity across multiple Microsoft Teams channels. Scans recent messages from each channel, identifies key discussions, decisions made, action items, and @‑mentions — then presents everything in a single, scannable digest. Ideal for managers, leads, or anyone tracking multiple project channels.

When to Use

• "What happened in my channels today?"
• "Summarize the last 3 days across all my project channels"
• "Give me a digest of Engineering and Product channels"
• "Any decisions made in the team channels this week?"
• "Channel digest for the sprint channels"
• "What did I miss in the channels while I was out?"

Instructions

Step 1: Identify the User

workiq-ask (
  question: "What is my profile information including display name, email, and time zone?"
)

Extract displayName, email, and timeZone.

Step 2: Discover Teams and Channels

List all teams and their channels:

workiq-ask (
  question: "List all Microsoft Teams teams I belong to and their channels."
)

If the user specified particular channels (e.g., "Engineering #general and #design-reviews"), filter to only those. Otherwise, include all non‑archived channels across relevant teams.

Build a channel inventory:

• Team name → Channel name
• Skip channels named "General" in low‑priority teams unless the user explicitly includes them.

Step 3: Pull Recent Messages from Each Channel

For each target channel, fetch recent messages within the lookback window:

workiq-ask (
  question: "Show me the last 30 messages in the '<channel name>' channel of the '<team name>' team including replies. For each message include the sender name, date and time, message content, reply count, any @mentions, reactions count, and any attachments or shared links."
)

For each message, capture:

• Sender display name
• Timestamp
• Content (text body for analysis)
• Reply count — indicates discussion depth
• Mentions — anyone @‑mentioned, especially the current user
• Reactions — high reaction count signals importance
• Attachments — files or links shared

Step 4: Analyze and Categorize Messages

For each channel, classify the messages into categories:

🔑 Key Decisions — messages containing:

• Decision language: "decided", "approved", "agreed", "going with", "finalized", "confirmed"
• Follow‑up with context about what was decided

💬 Active Discussions — threads with:

• 3+ replies indicating substantive conversation
• Multiple participants contributing
• Ongoing debate or open questions

📌 Action Items — messages containing:

• Task language: "action item", "TODO", "follow up", "need to", "can you", "please"
• Assignments: "@person please…", "owned by…"
• Deadlines: "by Friday", "due date", "EOD"

📢 Announcements — messages that are:

• From team owners or managers
• Posted with high importance
• Information‑sharing without expecting discussion

📎 Shared Resources — messages with:

• File attachments (documents, spreadsheets)
• Links to external resources, PRs, or documents

👤 Your Mentions — messages where the current user was @‑mentioned or referenced by name.

Step 5: Search for User Mentions Across Channels

Cast a wider net for the user's mentions:

workiq-ask (
  question: "Find all Teams channel messages that mention me or are directed at me in the last <lookback period>. Include the team name, channel name, sender, date, and message content for each."
)

Cross‑reference with messages already captured to avoid duplicates. Add any new mentions to the Your Mentions category.

Step 6: Compile the Consolidated Digest

Organize findings by channel, then surface cross‑channel themes at the top.

Output Format

📰 CHANNEL DIGEST
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📅 Period: {start date} → {end date}
🔍 Channels scanned: {N}  ·  💬 Messages analyzed: {N}

🎯 CROSS‑CHANNEL HIGHLIGHTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔑 {N} decisions made  ·  📌 {N} action items  ·  👤 {N} times you were mentioned

Top Decisions:
  1. {Team} › #{Channel}: "{decision summary}" — {Person}, {date}
  2. {Team} › #{Channel}: "{decision summary}" — {Person}, {date}

Action Items Needing You:
  • {Person} in #{Channel}: "{action item}" — due {date}
  • {Person} in #{Channel}: "{action item}"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📢 {Team Name} › #{Channel Name}
   💬 {N} messages  ·  🧵 {N} threads  ·  👥 {N} participants
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

   🔑 DECISIONS
   • "{Decision summary}" — {Person}, {date}

   💬 KEY DISCUSSIONS
   • "{Topic summary}" — {N} replies, {participants}
     └─ Status: {resolved / ongoing / needs input}

   📌 ACTION ITEMS
   • {Person}: "{task description}" — {due date or "no deadline"}

   📢 ANNOUNCEMENTS
   • {Person}: "{announcement summary}" — {date}

   📎 SHARED FILES
   • {filename} — shared by {Person}, {date}

   👤 YOUR MENTIONS
   • {Person}: "@you {message preview}" — {date}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📢 {Team Name} › #{Channel Name}
   💬 {N} messages  ·  ⏸️ Low activity
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   • {brief summary of the few messages}

🔇 QUIET CHANNELS (no messages in period)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   • {Team} › #{Channel}
   • {Team} › #{Channel}

Parameters

| Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | Lookback | No | 24 hours | Time window to scan (e.g., "3 days", "this week") | | Teams | No | All user's teams | Specific teams to include | | Channels | No | All channels | Specific channels to include | | Focus | No | All categories | Filter to "decisions", "action-items", or "mentions" | | Include Quiet | No | true | Whether to list channels with no activity | | Max Messages | No | 30 per channel | Maximum messages to pull per channel |

Required MCP Tools

| MCP Server | Tool | Purpose | |---|---|---| | workiq (Local WorkIQ CLI) | ask | User identity, team/channel discovery, message retrieval, and mention search |

Tips

• Say "digest for Engineering channels only" to narrow the scope and speed up results.
• Use "channel digest for the last week" before a Monday planning meeting to see what happened while you were out.
• Use action-item-extractor to pull action items from meeting content after reviewing channel activity.
• For recurring digests, establish a cadence: "give me my channel digest every morning."
• Ask "expand on the discussion in #{Channel}" to drill into a specific conversation with full context.

Examples

Example 1 — Morning standup prep (default 24-hour window)

"Give me a channel digest for today."

Scans all of the user's Teams channels for the past 24 hours, surfaces any decisions made overnight, flags action items assigned to the user, and lists @-mentions — all in a single digest organized by team and channel.

---

Example 2 — Catch up after time off (multi-day, scoped channels)

"Channel digest for the Engineering and Product channels over the last 5 days."

Limits the scan to channels in the Engineering and Product teams, pulls up to 30 messages per channel across the 5-day window, and highlights key decisions (e.g., architecture choices, scope changes), active threads, and any messages that mentioned the user while they were away.

---

Example 3 — Decision-focused digest before a planning meeting

"Show me only decisions and action items from the sprint channels this week."

Uses the Focus parameter to filter output to Key Decisions and Action Items only, skipping announcements and low-activity channel summaries. Ideal for quickly building a pre-meeting agenda from what was agreed or assigned across sprint-related channels.

Error Handling

No teams or channels found

• ask returns an empty result if the user is not a member of any team, or if the account lacks access to the Teams API.
• Resolution: Confirm the user's account has Microsoft Teams access and is a member of at least one team. Ask the user to specify a team name manually if discovery fails.

Channel message fetch returns empty or partial results

• ask may return fewer messages than expected if the channel has low activity or if the lookback window predates available message history (Teams message retention policies vary).
• Resolution: Proceed with available messages and note in the digest that history may be limited. Surface "No messages in period" for those channels in the Quiet Channels section rather than failing silently.

Permission denied on a channel

• Private channels require explicit membership; ask will indicate an access error if the user is not a member of a private channel even within a team they belong to.
• Resolution: Skip the inaccessible channel, log it as "access restricted" in the digest output, and continue processing remaining channels.

Search for mentions returns no results

• The mentions query via ask may return empty results for broad queries or large tenants.
• Resolution: Fall back to the mentions already captured during the per-channel message retrieval. Note that the mention search could not be completed so the Your Mentions section may be incomplete.

Slow responses with many channels

• Querying messages from a large number of channels requires multiple ask calls and may be slow.
• Resolution: Process channels in batches. Inform the user of the delay and suggest narrowing scope with the Teams or Channels parameters.