← teams-mcp

teams-mcp 0.3.3

npm · teams-mcp · current release

19
Tools
0
Resources
0
Templates
0
Prompts

Observation

Observed 2026-08-22T21:48:40.021Z using mcpSecurity-inventory. Status: succeeded. Negotiated protocol: 2025-06-18.

Server capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools 19

ToolCategoryAnnotationsRisk
auth_statusCheck the authentication status of the Microsoft Graph connection. Returns whether the user is authenticated and shows their basic profile information.
Input schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}
—— · ——
create_chatCreate a new chat conversation. Can be a 1:1 chat (with one other user) or a group chat (with multiple users). Group chats can optionally have a topic.
Input schema
{
  "type": "object",
  "properties": {
    "userEmails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of user email addresses to add to chat"
    },
    "topic": {
      "type": "string",
      "description": "Chat topic (for group chats)"
    }
  },
  "required": [
    "userEmails"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
get_channel_message_repliesGet all replies to a specific message in a channel. Returns reply content, sender information, and timestamps.
Input schema
{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID to get replies for"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Number of replies to retrieve (default: 20)"
    }
  },
  "required": [
    "teamId",
    "channelId",
    "messageId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
get_channel_messagesRetrieve recent messages from a specific channel in a Microsoft Team. Returns message content, sender information, and timestamps.
Input schema
{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Number of messages to retrieve (default: 20)"
    }
  },
  "required": [
    "teamId",
    "channelId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
get_chat_messagesRetrieve recent messages from a specific chat conversation. Returns message content, sender information, and timestamps.
Input schema
{
  "type": "object",
  "properties": {
    "chatId": {
      "type": "string",
      "description": "Chat ID (e.g. 19:meeting_Njhi..j@thread.v2"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Number of messages to retrieve"
    },
    "since": {
      "type": "string",
      "description": "Get messages since this ISO datetime"
    },
    "until": {
      "type": "string",
      "description": "Get messages until this ISO datetime"
    },
    "fromUser": {
      "type": "string",
      "description": "Filter messages from specific user ID"
    },
    "orderBy": {
      "type": "string",
      "enum": [
        "createdDateTime",
        "lastModifiedDateTime"
      ],
      "default": "createdDateTime",
      "description": "Sort order"
    },
    "descending": {
      "type": "boolean",
      "default": true,
      "description": "Sort in descending order (newest first)"
    }
  },
  "required": [
    "chatId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
get_current_userGet the current authenticated user's profile information including display name, email, job title, and department.
Input schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}
—— · ——
get_my_mentionsFind all recent messages where the current user was mentioned (@mentioned) across Teams channels and chats.
Input schema
{
  "type": "object",
  "properties": {
    "hours": {
      "type": "number",
      "minimum": 1,
      "maximum": 168,
      "default": 24,
      "description": "Get mentions from the last N hours"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 20,
      "description": "Maximum number of mentions to return"
    },
    "scope": {
      "type": "string",
      "enum": [
        "all",
        "channels",
        "chats"
      ],
      "default": "all",
      "description": "Scope of search"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
get_recent_messagesGet recent messages from across Teams with advanced filtering options. Can filter by time range, scope (channels vs chats), teams, channels, and users.
Input schema
{
  "type": "object",
  "properties": {
    "hours": {
      "type": "number",
      "minimum": 1,
      "maximum": 168,
      "default": 24,
      "description": "Get messages from the last N hours (max 168 = 1 week)"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 50,
      "description": "Maximum number of messages to return"
    },
    "mentionsUser": {
      "type": "string",
      "description": "Filter messages that mention this user ID"
    },
    "fromUser": {
      "type": "string",
      "description": "Filter messages from this user ID"
    },
    "hasAttachments": {
      "type": "boolean",
      "description": "Filter messages with attachments"
    },
    "importance": {
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ],
      "description": "Filter by message importance"
    },
    "includeChannels": {
      "type": "boolean",
      "default": true,
      "description": "Include channel messages"
    },
    "includeChats": {
      "type": "boolean",
      "default": true,
      "description": "Include chat messages"
    },
    "teamIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific team IDs to search in"
    },
    "keywords": {
      "type": "string",
      "description": "Keywords to search for in message content"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
get_userGet detailed information about a specific user by their ID or email address. Returns profile information including name, email, job title, and department.
Input schema
{
  "type": "object",
  "properties": {
    "userId": {
      "type": "string",
      "description": "User ID or email address"
    }
  },
  "required": [
    "userId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
list_channelsList all channels in a specific Microsoft Team. Returns channel names, descriptions, types, and IDs for the specified team.
Input schema
{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  },
  "required": [
    "teamId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
list_chatsList all recent chats (1:1 conversations and group chats) that the current user participates in. Returns chat topics, types, and participant information.
Input schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}
—— · ——
list_team_membersList all members of a specific Microsoft Team. Returns member names, email addresses, roles, and IDs.
Input schema
{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  },
  "required": [
    "teamId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
list_teamsList all Microsoft Teams that the current user is a member of. Returns team names, descriptions, and IDs.
Input schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {}
}
—— · ——
reply_to_channel_messageReply to a specific message in a channel. Supports text and markdown formatting, mentions, and importance levels.
Input schema
{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID to reply to"
    },
    "message": {
      "type": "string",
      "description": "Reply content"
    },
    "importance": {
      "type": "string",
      "enum": [
        "normal",
        "high",
        "urgent"
      ],
      "description": "Message importance"
    },
    "format": {
      "type": "string",
      "enum": [
        "text",
        "markdown"
      ],
      "description": "Message format (text or markdown)"
    },
    "mentions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mention": {
            "type": "string",
            "description": "The @mention text (e.g., 'john.doe' or 'john.doe@company.com')"
          },
          "userId": {
            "type": "string",
            "description": "Azure AD User ID of the mentioned user"
          }
        },
        "required": [
          "mention",
          "userId"
        ],
        "additionalProperties": false
      },
      "description": "Array of @mentions to include in the reply"
    },
    "imageUrl": {
      "type": "string",
      "description": "URL of an image to attach to the reply"
    },
    "imageData": {
      "type": "string",
      "description": "Base64 encoded image data to attach"
    },
    "imageContentType": {
      "type": "string",
      "description": "MIME type of the image (e.g., 'image/jpeg', 'image/png')"
    },
    "imageFileName": {
      "type": "string",
      "description": "Name for the attached image file"
    }
  },
  "required": [
    "teamId",
    "channelId",
    "messageId",
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
search_messagesSearch for messages across all Microsoft Teams channels and chats using Microsoft Search API. Supports advanced KQL syntax for filtering by sender, mentions, attachments, and more.
Input schema
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query. Supports KQL syntax like 'from:user mentions:userId hasAttachment:true'"
    },
    "scope": {
      "type": "string",
      "enum": [
        "all",
        "channels",
        "chats"
      ],
      "default": "all",
      "description": "Scope of search"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "Number of results to return"
    },
    "enableTopResults": {
      "type": "boolean",
      "default": true,
      "description": "Enable relevance-based ranking"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
search_usersSearch for users in the organization by name or email address. Returns matching users with their basic profile information.
Input schema
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query (name or email)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
search_users_for_mentionsSearch for users to mention in messages. Returns users with their display names, email addresses, and mention IDs.
Input schema
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query (name or email)"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Maximum number of results to return"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
send_channel_messageSend a message to a specific channel in a Microsoft Team. Supports text and markdown formatting, mentions, and importance levels.
Input schema
{
  "type": "object",
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "message": {
      "type": "string",
      "description": "Message content"
    },
    "importance": {
      "type": "string",
      "enum": [
        "normal",
        "high",
        "urgent"
      ],
      "description": "Message importance"
    },
    "format": {
      "type": "string",
      "enum": [
        "text",
        "markdown"
      ],
      "description": "Message format (text or markdown)"
    },
    "mentions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mention": {
            "type": "string",
            "description": "The @mention text (e.g., 'john.doe' or 'john.doe@company.com')"
          },
          "userId": {
            "type": "string",
            "description": "Azure AD User ID of the mentioned user"
          }
        },
        "required": [
          "mention",
          "userId"
        ],
        "additionalProperties": false
      },
      "description": "Array of @mentions to include in the message"
    },
    "imageUrl": {
      "type": "string",
      "description": "URL of an image to attach to the message"
    },
    "imageData": {
      "type": "string",
      "description": "Base64 encoded image data to attach"
    },
    "imageContentType": {
      "type": "string",
      "description": "MIME type of the image (e.g., 'image/jpeg', 'image/png')"
    },
    "imageFileName": {
      "type": "string",
      "description": "Name for the attached image file"
    }
  },
  "required": [
    "teamId",
    "channelId",
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——
send_chat_messageSend a message to a specific chat conversation. Supports text and markdown formatting, mentions, and importance levels.
Input schema
{
  "type": "object",
  "properties": {
    "chatId": {
      "type": "string",
      "description": "Chat ID"
    },
    "message": {
      "type": "string",
      "description": "Message content"
    },
    "importance": {
      "type": "string",
      "enum": [
        "normal",
        "high",
        "urgent"
      ],
      "description": "Message importance"
    },
    "format": {
      "type": "string",
      "enum": [
        "text",
        "markdown"
      ],
      "description": "Message format (text or markdown)"
    },
    "mentions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "mention": {
            "type": "string",
            "description": "The @mention text (e.g., 'john.doe' or 'john.doe@company.com')"
          },
          "userId": {
            "type": "string",
            "description": "Azure AD User ID of the mentioned user"
          }
        },
        "required": [
          "mention",
          "userId"
        ],
        "additionalProperties": false
      },
      "description": "Array of @mentions to include in the message"
    }
  },
  "required": [
    "chatId",
    "message"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
—— · ——

Resources 0

Resource templates 0

Prompts 0

Let’s talk about MCP security.

Share your details and our security team will contact you.