MCP server intelligence profile

teams-mcp Server

Enables AI assistants to interact with Microsoft Teams, users, chats, files, and organizational data via Microsoft Graph APIs, with added support for creating, updating, listing, and inspecting Teams meetings and calendar events

Local Onlygoddivor
Awaiting current scanNpm · 0.3.3

The selected current version does not yet have completed public verification. Unknown does not mean clean or vulnerable.

1Distribution channel
19Independently observed tools
0Linked remote endpoints
AvailableVersion intelligence

Detailed security scan evidence is not public for this MCP yet. Public identity, registry metadata, and independently observed protocol inventory remain available.

Install and connect

Installation and connection instructions are shown only when supported by retained package, repository, or endpoint evidence.

Install teams-mcp from npm

Version 0.3.3 declares 1 executable entrypoint.

npm install --save-exact teams-mcp@0.3.3
npx -y -p teams-mcp@0.3.3 teams-mcp
MCP client configuration example
{
  "mcpServers": {
    "teams-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "teams-mcp@0.3.3",
        "teams-mcp"
      ]
    }
  }
}

Identity

Canonical slugteams-mcp-08503379DeploymentLocal Only
Canonical packagenpm:teams-mcpRepositorygoddivor/teams-mcp
First published—Latest release—
Last security verification—Classification confidence90%
PublicationDraftOfficial distributionNot verified

Distributions

ChannelIdentifierCurrent versionVersionsSource
npmteams-mcp0.3.31Repository

Current release

PackageVersionPublished / observedInventorySecurity scan
npmteams-mcp0.3.3CurrentSep 5, 202619 toolsSucceeded · 0 resources · 0 promptsEvidence restricted
Enterprise protection

Continuously monitor this MCP for security risk

Independently scan the exact version your agents use, receive alerts when its risk changes, and investigate every finding with retained version evidence.

  • Independent exact-version security scans
  • Continuous release and vulnerability monitoring
  • Risk-change alerts with capability context
  • Historical evidence and API exports
Custom pricingContact salesTailored to your organization, integrations, data needs, and support requirements.

Current version evidence

No public current-version evidence is available yet.

Current protocol inventory

2025-06-18Negotiated protocol
teams-mcpServer-reported name
1Capability groups
Aug 22, 2026Observed

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

  • None observed.

Resource templates 0

  • None observed.

Prompts 0

  • None observed.

Remote endpoints

EndpointTransportAuthenticationHealthObserved
No verified remote endpoint is linked.

teams-mcp Server questions

How do I install teams-mcp Server?

Install the selected package version with: npm install --save-exact teams-mcp@0.3.3

What tools does teams-mcp Server provide?

teams-mcp Server exposed 19 tools during independent protocol observation, including auth_status, create_chat, get_channel_message_replies, get_channel_messages, get_chat_messages, get_current_user, get_my_mentions, get_recent_messages, and others.

Is teams-mcp Server secure?

The selected current version does not yet have completed public verification. Unknown does not mean clean or vulnerable.

Company and product intelligence

These internal links are derived from strong identity fields such as the implementation name, package, repository, vendor, and listing name—not generic description prose.

Associated company landscape

Microsoft & Azure intelligence →

Association is based on retained identity fields; it does not by itself prove first-party publication.

Microsoft Teams 40 matches

Explore related MCP server guides

Curated product and capability guides containing this catalog record.

Official vs Community MCP Servers

Let’s talk about MCP security.

Share your details and our security team will contact you.