Teams MCP - Tools

The Teams MCP Server exposes 12 tools in two categories:

• Chat & messaging tools (8) interact with Microsoft Teams chats and channels synchronously through the Microsoft Graph API: list teams/channels/chats, read messages, search across messages, and send messages.

• Transcript & knowledge-base tools (4) manage meeting-transcript ingestion into the Unique knowledge base.

Chat and messaging tools target chats and channels by id: you discover the id with a list_* tool (or search_messages), then pass it to the tool that reads or writes:

list_teams / list_chats / list_channels  →  id  →  get_*_messages / send_*_message

The list_* tools return distinguishing metadata (creation dates, last-message timestamps, archived/membership flags, member names) so the agent can pick the right id when several teams, chats, or channels share a display name.

Tool Overview

Mutating means the tool writes data to at least one of the following:

• Microsoft Teams — posts a new message to a chat or channel via Microsoft Graph, on behalf of the signed-in user

• Internal database — persists or removes state managed by this server (e.g. the transcript-ingestion subscription record)

• Unique knowledge base — queues meeting-transcript content for indexing into the knowledge base

Teams & Channels

list_teams

List all Microsoft Teams the signed-in user is a member of. Each team carries an isArchived flag (archived teams are read-only) to distinguish teams that share a display name.

Input parameters:

Returns: A teams array. Each entry has teamId, displayName, isArchived (true/false/null), and description (only when includeDescriptions is true and a description exists). Pass teamId to list_channels, get_channel_messages, or send_channel_message.

Example:

{
  "teams": [
    { "teamId": "19:abc...@thread.tacv2", "displayName": "Engineering", "isArchived": false },
    { "teamId": "19:def...@thread.tacv2", "displayName": "Engineering", "isArchived": true }
  ]
}

list_channels

List all channels in a team, identified by teamId. Each channel carries its creation date and membership type (standard, private, or shared) to tell apart channels that share a display name.

Input parameters:

Returns: The teamId and a channels array. Each entry has channelId, displayName, createdDateTime, membershipType, and description (only when includeDescriptions is true). Pass teamId + channelId to get_channel_messages or send_channel_message.

Example:

{
  "teamId": "19:abc...@thread.tacv2",
  "channels": [
    {
      "channelId": "19:ch1...@thread.tacv2",
      "displayName": "General",
      "createdDateTime": "2023-04-01T09:00:00Z",
      "membershipType": "standard"
    }
  ]
}

Chats

list_chats

List the signed-in user's chats (1:1, group, and meeting chats), most recent first. Each chat carries its creation date and last-message timestamp to tell apart chats that share a topic or members. For chats without a topic (typically 1:1 chats), the member list is returned so the chat can be identified by participant.

Input parameters:

Returns: A chats array and a truncated flag (true when more chats exist than were returned). Each chat has chatId, chatType, topic (nullable), createdDateTime, lastMessageAt, and — for chats without a topic — a members array (displayName, plus email when includeMemberEmails is true). Pass chatId to get_chat_messages or send_chat_message.

Example:

{
  "chats": [
    {
      "chatId": "19:meeting_xyz@thread.v2",
      "chatType": "meeting",
      "topic": "Weekly Sync",
      "createdDateTime": "2024-01-10T08:00:00Z",
      "lastMessageAt": "2024-06-20T14:32:00Z"
    },
    {
      "chatId": "19:1on1@unq.gbl.spaces",
      "chatType": "oneOnOne",
      "topic": null,
      "createdDateTime": "2023-11-02T10:00:00Z",
      "lastMessageAt": "2024-06-19T09:15:00Z",
      "members": [{ "displayName": "Alice Smith" }]
    }
  ],
  "truncated": false
}

Messages

The two get_*_messages tools share the same content-shaping options. Content can be returned normalized (the default — Teams HTML converted to readable plain text) or raw (Teams HTML verbatim). Normalization rewrites <at>Name</at> mentions to @Name, attachment references to [attachment: name] (or [attachment] when the name is unknown), adaptive-card payloads to [card], and blank/tombstone messages to [deleted].

get_chat_messages

Retrieve recent messages from a chat, identified by chatId. Call list_chats (or search_messages) first to find the chatId.

Input parameters:

Returns: The chatId and a messages array (newest first). Each message has id, senderDisplayName (nullable), content, createdDateTime (omitted when timestampFormat=none), and contentType (only when detail=full).

Example:

{
  "chatId": "19:1on1@unq.gbl.spaces",
  "messages": [
    {
      "id": "1718901120000",
      "senderDisplayName": "Alice Smith",
      "content": "@Bob Jones can you review the PR? [attachment: design.pdf]",
      "createdDateTime": "2024-06-20 14:32"
    }
  ]
}

get_channel_messages

Retrieve recent messages from a channel, identified by teamId + channelId. Call list_teams then list_channels first to find the ids.

Input parameters:

Returns: The teamId, channelId, and a messages array (same shape as get_chat_messages).

Example:

{
  "teamId": "19:abc...@thread.tacv2",
  "channelId": "19:ch1...@thread.tacv2",
  "messages": [
    {
      "id": "1718900000000",
      "senderDisplayName": "Carol Lee",
      "content": "Deploy is green.",
      "createdDateTime": "2024-06-20 13:50"
    }
  ]
}

send_chat_message

Send a plain-text message to a chat (1:1 or group), identified by chatId. Call list_chats first to find the chatId.

Input parameters:

Returns:messageId and the chatId the message was posted to.

Example:

{ "messageId": "1718901500000", "chatId": "19:1on1@unq.gbl.spaces" }

send_channel_message

Send a plain-text message to a channel, identified by teamId + channelId. Call list_teams then list_channels first to find the ids.

Input parameters:

Returns:messageId, and webUrl when includeWebUrl is true and Graph returned one.

Example:

{ "messageId": "1718901600000", "webUrl": "https://teams.microsoft.com/l/message/..." }

Search

search_messages

Search Microsoft Teams messages by keyword across 1:1 chats, group chats, and channels in a single query, using the Microsoft Search API (POST /search/query on Graph v1.0). Supports identity and scope filters. Results are snippets by default; set detail=full to hydrate message bodies. At least one search criterion (query, from, to, mentions, sentAfter, sentBefore, hasAttachment, isRead, or isMentioned) must be provided.

Input parameters:

Returns: A messages array, returnedCount (rows on this page, after the source filter — not total corpus matches), and moreResultsAvailable (paginate with offset until this is false). Each hit has:

Pass the returned chatId (or teamId + channelId) straight to get_*_messages or send_*_message.

Example:

{
  "messages": [
    {
      "id": "1718900000000",
      "source": "channel",
      "chatId": null,
      "teamId": "19:abc...@thread.tacv2",
      "channelId": "19:ch1...@thread.tacv2",
      "senderDisplayName": "Carol Lee",
      "summary": "Deploy is <c0>green</c0>.",
      "createdDateTime": "2024-06-20T13:50:00Z",
      "webUrl": "https://teams.microsoft.com/l/message/..."
    }
  ],
  "returnedCount": 1,
  "moreResultsAvailable": false
}

Transcript & Knowledge-Base Management

These tools manage the ingestion of meeting transcripts into the Unique knowledge base, where they are then searched and queried from within Unique. This is distinct from the message tools above — chat and channel messages are never ingested.

ingest_meeting

Ingest a specific Teams meeting's transcript on demand, identified by its join URL. Use this to ingest a meeting that predates the knowledge-base integration, or to re-pull a single occurrence. You must be the organizer or an invited attendee. Ingestion runs asynchronously; the tool returns once the transcript is queued.

Input parameters:

Returns:success, a human-readable message, meeting (id, subject, joinUrl — or null if not found), and queued (array of { transcriptId, createdDate } for each transcript queued for ingestion).

Example:

{
  "success": true,
  "message": "Queued 1 transcript(s) for ingestion. They will appear in the knowledge base shortly.",
  "meeting": { "id": "MSo...", "subject": "Q2 Planning", "joinUrl": "https://teams.microsoft.com/l/meetup-join/..." },
  "queued": [{ "transcriptId": "MSMjMCMj...", "createdDate": "2024-06-01T10:05:00.000Z" }]
}

verify_kb_integration_status

Check the status of the transcript-ingestion knowledge-base integration: whether automatic ingestion is active, expiring soon, expired, or not configured.

Input parameters: None

Returns:status (active | expiring_soon | expired | not_configured), a message, and subscription (id, expiresAt, minutesUntilExpiration, createdAt, updatedAt — or null when not configured).

start_kb_integration

Start automatic ingestion of meeting transcripts into the knowledge base. Creates a Microsoft Graph webhook subscription so new transcripts are ingested as they become available. Safe to call when already active — it returns already_active without creating a duplicate.

Input parameters: None

Returns:success, a message, and subscription (id, expiresAt, minutesUntilExpiration, status — one of created, already_active, expiring_soon).

stop_kb_integration

Stop automatic ingestion of meeting transcripts. Removes the Microsoft Graph webhook subscription; previously ingested transcripts remain in the knowledge base.

Input parameters: None

Returns:success, a message, and subscription (id, status — removed or not_found — or null when nothing was active).

Related Documentation

• Architecture - System components, including the chat and transcript modules

• Flows - Sequence diagrams for the read, search, send, and transcript flows

• Subscription Management - Lifecycle behind start_kb_integration / stop_kb_integration / verify_kb_integration_status

• Permissions - Microsoft Graph permissions required by these tools

• Security - Token isolation, delegated access, and the message-send write surface