teams_send_channel_message

Microsoft Teams · macOS · Windows

Effect: send (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Sends a text message to a Microsoft Teams channel via Graph API. Requires connect_m365_account with Chat.ReadWrite / ChannelMessage.Send permissions. team_id and channel_id must come from teams_list_teams / teams_list_channels. First call returns a preview; set confirm=true to send.

Required inputs

team_id — Team ID from teams_list_teams, or the team's name
channel_id — Channel ID from teams_list_channels, or the channel's name
text — Plain-text message body

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "channel_id": {
      "description": "Channel ID from teams_list_channels, or the channel's name",
      "type": "string"
    },
    "confirm": {
      "description": "Set true to send; false returns preview",
      "type": "boolean"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams, or the team's name",
      "type": "string"
    },
    "text": {
      "description": "Plain-text message body",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id",
    "text"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "channel_id": "demo-channel-001",
  "confirm": false,
  "team_id": "demo-team-001",
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows