Microsoft Teams

Manage Microsoft Teams channels and messages via Microsoft Graph

Overview

Microsoft Teams tools let you list teams, channels, chats, channel messages, and chat messages, add members to teams, private or shared channels, and group chats, send messages to channels or chats (DMs), reply to channel threads, create channels, and create one-on-one or group chats through Microsoft Graph.

Key Features

• TEAMS_LIST_TEAMS
  • Get a list of teams the user has joined.
• TEAMS_LIST_CHANNELS
  • Get a list of channels in a team.
• TEAMS_LIST_CHANNEL_MESSAGES
  • Get messages posted in a channel, optionally including thread replies.
• TEAMS_LIST_CHATS
  • Get a list of chats the signed-in user participates in.
• TEAMS_LIST_CHAT_MESSAGES
  • Get messages posted in a one-on-one or group chat.
• TEAMS_ADD_CHANNEL_MEMBER
  • Add a user to a private or shared channel as a member or owner.
• TEAMS_ADD_TEAM_MEMBER
  • Add a user to a team as a member or owner. Use this for standard (public) channels, which inherit team membership.
• TEAMS_ADD_CHAT_MEMBER
  • Add a user to an existing group chat, optionally sharing prior history.
• TEAMS_SEND_MESSAGE
  • Send messages to Teams channels (plain text or HTML format).
• TEAMS_REPLY_TO_MESSAGE
  • Reply to a Teams channel message thread.
• TEAMS_CREATE_CHANNEL
  • Create new channels within a team (public or private).
• TEAMS_CREATE_CHAT
  • Create a new 1-on-1 or group chat. The signed-in user is added automatically.
• TEAMS_SEND_CHAT_MESSAGE
  • Send a message to a Teams chat (DM). Supports plain text and HTML.

Authentication

These tools require a Microsoft Graph OAuth token.

Go to the Jinba secrets dashboard and connect a Microsoft account for Teams. Use the generated token in the tool config.

The Teams OAuth connection requests Microsoft Graph scopes for channel messages, chat messages, channels, channel membership, team membership, chat membership, teams, sending messages, and token refresh. Existing Teams secrets created before these scopes were added must be reconnected. Adding team members (TeamMember.ReadWrite.All) or chat members (ChatMember.ReadWrite) may require tenant admin consent.

Example: List Teams, Create a Private Channel, Add a Member, and Send Message

- id: list_teams
  name: list_teams
  tool: TEAMS_LIST_TEAMS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input: []

- id: list_channels
  name: list_channels
  tool: TEAMS_LIST_CHANNELS
  needs: ["list_teams"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"

- id: list_channel_messages
  name: list_channel_messages
  tool: TEAMS_LIST_CHANNEL_MESSAGES
  needs: ["list_teams", "list_channels"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_id
      value: "{{steps.list_channels.result.channels[0].id}}"
    - name: include_replies
      value: true

- id: list_chats
  name: list_chats
  tool: TEAMS_LIST_CHATS
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input: []

- id: list_chat_messages
  name: list_chat_messages
  tool: TEAMS_LIST_CHAT_MESSAGES
  needs: ["list_chats"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: chat_id
      value: "{{steps.list_chats.result.chats[0].id}}"

- id: create_channel
  name: create_channel
  tool: TEAMS_CREATE_CHANNEL
  needs: ["list_teams"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_name
      value: "project-alpha-2025"
    - name: description
      value: "Project Alpha for FY2025"
    - name: is_private
      value: true

- id: add_channel_member
  name: add_channel_member
  tool: TEAMS_ADD_CHANNEL_MEMBER
  needs: ["create_channel"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_id
      value: "{{steps.create_channel.result.channel_id}}"
    - name: user_id
      value: "[e-mail]"
    - name: role
      value: "member"

- id: send_message
  name: send_message
  tool: TEAMS_SEND_MESSAGE
  needs: ["add_channel_member"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: team_id
      value: "{{steps.list_teams.result.teams[0].id}}"
    - name: channel_id
      value: "{{steps.create_channel.result.channel_id}}"
    - name: message
      value: "Daily Report: Completed 15 tasks, 8 in progress"
    - name: message_type
      value: "text"

Example: Create a 1-on-1 Chat and Send a DM

- id: create_chat
  name: create_chat
  tool: TEAMS_CREATE_CHAT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: chat_type
      value: "oneOnOne"
    - name: member_ids
      value: "[e-mail]"

- id: send_chat_message
  name: send_chat_message
  tool: TEAMS_SEND_CHAT_MESSAGE
  needs: ["create_chat"]
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_TEAMS.access_token}}"
  input:
    - name: chat_id
      value: "{{steps.create_chat.result.chat_id}}"
    - name: message
      value: "Hello! I wanted to reach out directly."
    - name: message_type
      value: "text"