teams

Teams

When to Use

Activate this skill when the user:

• Asks to send a message or reply to someone in Teams
• Wants to schedule, list, or manage meetings
• Needs to create or manage Teams channels
• Asks to create a poll or survey
• Wants to check someone's presence/availability
• Says "message [name]...", "schedule a meeting with...", "create a poll for..."
• Needs to share files or manage Teams resources

Instructions

Sending Messages

To a 1:1 or Group Chat

Use teams_send_message with the chat ID. Messages support markdown:

• Bold: **text**
• Italic: *text*
• Code: `code`
• Links: [text](url)
• Lists: - item or 1. item

Replying to a Specific Message

Use teams_reply_to_message when you need to reply in a thread, providing both the chat/channel ID and the parent message ID.

Reacting to Messages

Use teams_react_to_message to add reactions. Supported reaction types:

• like, angry, sad, laugh, heart, surprised

Adaptive Cards

Use teams_send_adaptive_card for rich, interactive messages. Common card patterns:

Information Card

{
  "type": "AdaptiveCard",
  "version": "1.4",
  "body": [
    { "type": "TextBlock", "text": "Title", "size": "Large", "weight": "Bolder" },
    { "type": "TextBlock", "text": "Description text", "wrap": true },
    { "type": "FactSet", "facts": [
      { "title": "Status", "value": "Active" },
      { "title": "Priority", "value": "High" }
    ]}
  ]
}

Action Card (with buttons)

{
  "type": "AdaptiveCard",
  "version": "1.4",
  "body": [
    { "type": "TextBlock", "text": "Approval Required", "weight": "Bolder" },
    { "type": "TextBlock", "text": "PR #23 needs your review", "wrap": true }
  ],
  "actions": [
    { "type": "Action.OpenUrl", "title": "View PR", "url": "https://..." },
    { "type": "Action.Submit", "title": "Approve", "data": { "action": "approve" } }
  ]
}

Meeting Scheduling

Use teams_schedule_meeting with:

• subject — clear, descriptive meeting title
• startTime — ISO 8601 format (e.g., 2026-03-05T14:00:00Z)
• endTime — ISO 8601 format
• attendees — list of email addresses
• body — optional agenda or description

Meeting Etiquette

• Include an agenda in the meeting body
• Default to 30 minutes unless specified otherwise
• Check attendee presence/availability first with teams_get_presence

Channel Management

Use teams_create_channel with:

• displayName — clear, descriptive name
• description — explain the channel's purpose
• membershipType — standard (visible to all) or private

Polls

Use teams_create_poll for quick team feedback:

• Keep questions clear and concise
• Limit to 2-6 options

User Information

• teams_get_user_info — get profile details (name, email, title, department)
• teams_get_presence — check availability (Available, Busy, DoNotDisturb, Away, Offline)
• teams_list_members — list members of a team or chat

Tools

Messaging

• teams_send_message — Send message to a chat (1:1 or group)
• teams_reply_to_message — Reply to a specific message thread
• teams_react_to_message — Add emoji reaction to a message
• teams_create_post — Create a post in a channel (with optional subject)
• teams_send_adaptive_card — Send an Adaptive Card to a chat

Discovery

• teams_list_chats — List user's chats (find chat IDs)
• teams_get_chat_messages — Get recent messages from a chat
• teams_list_teams — List teams the user belongs to
• teams_list_channels — List channels in a team
• teams_get_channel_info — Get channel details and members
• teams_get_channel_messages — Get recent posts in a channel
• teams_get_channel_message_replies — Get replies to a channel post

People

• teams_list_members — List members of a chat or team
• teams_get_user_info — Get user profile by ID or UPN
• teams_get_presence — Check user's online status

Meetings

• teams_schedule_meeting — Schedule a meeting with online link
• teams_list_meetings — List upcoming meetings
• teams_get_meeting_details — Get full meeting details

Other

• teams_create_channel — Create a new channel in a team
• teams_create_poll — Create a poll via Adaptive Card
• teams_share_file — Share a OneDrive/SharePoint file in a chat

Direct Messaging Workflow

When sending direct messages by name or email, teams_send_message requires the actual Teams chat ID (format: 19:xxxxx@thread.v2), not display names or emails.

Discovery workflow:

1. teams_list_chats() — get all available chats
2. teams_list_members({ chatId: "..." }) — check each one-on-one chat to find the target user
3. teams_send_message({ chatId: "found-chat-id", content: "message" }) — send to the identified chat

See Also

• outlook — for email communication
• sharepoint — for file upload before sharing via teams_share_file