MCP Microsoft Teams Server

Instructions

Implementation Reference

• src/mcp_teams_server/__init__.py:108-121 (handler)

  MCP tool handler function for 'start_thread', including input schema via Pydantic Fields, which delegates to TeamsClient.start_thread

  @mcp.tool(
      name="start_thread", description="Start a new thread with a given title and content"
  )
  async def start_thread(
      ctx: Context,
      title: str = Field(description="The thread title"),
      content: str = Field(description="The thread content"),
      member_name: str | None = Field(
          description="Member name to mention in the thread", default=None
      ),
  ) -> TeamsThread:
      await ctx.debug(f"start_thread with title={title} and content={content}")
      client = _get_teams_client(ctx)
      return await client.start_thread(title, content, member_name)

• src/mcp_teams_server/teams.py:121-182 (helper)

  Core implementation of thread starting in TeamsClient, using BotFramework CloudAdapter to send an Activity with topic_name as title, optionally mentioning a member

  async def start_thread(
      self, title: str, content: str, member_name: str | None = None
  ) -> TeamsThread:
      """Start a new thread in a channel.
  
      Args:
          title: Thread title
          content: Initial thread content
          member_name: Member name to mention in content
  
      Returns:
          Created thread details including ID
      """
      try:
          await self._initialize()
  
          result = TeamsThread(title=title, content=content, thread_id="")
  
          async def start_thread_callback(context: TurnContext):
              mention_member = None
              if member_name is not None:
                  members = await TeamsInfo.get_team_members(context, self.team_id)
                  for member in members:
                      if member.name == member_name:
                          mention_member = member
  
              mentions = []
              if mention_member is not None:
                  result.content = (
                      f"# **{title}**\n<at>{mention_member.name}</at> {content}"
                  )
                  mention = Mention(
                      text=f"<at>{mention_member.name}</at>",
                      type="mention",
                      mentioned=ChannelAccount(
                          id=mention_member.id, name=mention_member.name
                      ),
                  )
                  mentions.append(mention)
  
              response = await context.send_activity(
                  activity_or_text=Activity(
                      type=ActivityTypes.message,
                      topic_name=title,
                      text=result.content,
                      text_format=TextFormatTypes.markdown,
                      entities=mentions,
                  )
              )
              if response is not None:
                  result.thread_id = response.id
  
          await self.adapter.continue_conversation(
              bot_app_id=self.teams_app_id,
              reference=self._create_conversation_reference(),
              callback=start_thread_callback,
          )
  
          return result
      except Exception as e:
          LOGGER.error(f"Error creating thread: {str(e)}")
          raise

• src/mcp_teams_server/teams.py:36-42 (schema)

  Pydantic model for TeamsThread, used as return type for start_thread

  class TeamsThread(BaseModel):
      thread_id: str = Field(
          description="Thread ID as a string in the format '1743086901347'"
      )
      title: str = Field(description="Message title")
      content: str = Field(description="Message content")

• src/mcp_teams_server/__init__.py:108-121 (registration)

  The @mcp.tool decorator registers the start_thread handler with name='start_thread'

  @mcp.tool(
      name="start_thread", description="Start a new thread with a given title and content"
  )
  async def start_thread(
      ctx: Context,
      title: str = Field(description="The thread title"),
      content: str = Field(description="The thread content"),
      member_name: str | None = Field(
          description="Member name to mention in the thread", default=None
      ),
  ) -> TeamsThread:
      await ctx.debug(f"start_thread with title={title} and content={content}")
      client = _get_teams_client(ctx)
      return await client.start_thread(title, content, member_name)