All servers / Chat / Microsoft Teams MCP server
Microsoft Teams MCP server
MCP server for Microsoft Teams - search messages, send replies, manage favourites
Tested by ConnectATDScore 90 out of 100. Tested 2026-11-18 on package version 0.31.5. Package: msteams-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (4.1 seconds including download)
- Tools offered: 40
- Last published: 2026-11-18
- Weekly downloads (npm): 2,860
- License: MIT · Direct dependencies: 4
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
teams_search4 of 4 parameters describedSearch for messages in Microsoft Teams. Returns matching messages with sender, timestamp, content, conversationId (for replies), and pagination info. Supports operators: from:email, to:name, sent:YYYY-MM-DD, sent:today, is:Messages, is:Meetings, is:Channels, is:Chats, hasattachment:true, "Name" for @mentions. The in:channel operator only works reliably when combined with content (e.g., "meeting in:IT Support"). Combine with NOT to exclude. Results sorted by recency.
teams_get_thread8 of 8 parameters describedGet messages from a Teams conversation/thread. Default: newest-first (latest messages at top). For channels: messages include isThreadReply (true for replies) and threadRootId (ID of the post being replied to). Messages without threadRootId are top-level posts. Use threadRootId to group related messages. Messages include reactions (individual reactors, names resolved where possible) and reactionSummary (counts per emoji) when present. Each message includes a "when" field with the day of week (e.g., "Friday, January 30, 2026, 10:45 AM UTC"). Returns unread count and can optionally mark as read. Pass olderCursor back as cursor to page through older history.
teams_find_channel2 of 2 parameters describedFind Teams channels by name. Searches both (1) channels in teams you're a member of (reliable) and (2) channels across the organisation (discovery). Results indicate whether you're already a member via the isMember field. Channel IDs can be used with teams_get_thread to read messages.
teams_search_email4 of 4 parameters describedSearch emails in the user's mailbox. Returns matching emails with subject, sender, recipients, timestamp, preview, read status, and pagination info. Each result's id can be passed to teams_get_email to fetch the full body, recipients and attachment list. Supports the same search operators as Outlook: from:email, to:name, subject:"text", hasattachment:true, sent:YYYY-MM-DD, sent:>=YYYY-MM-DD, sent:today, is:read, is:unread. Results sorted by recency. Uses the same authentication as Teams — no additional login required.
teams_get_email1 of 1 parameter describedFetch the full content of one email: complete body, all recipients (to/cc/bcc), and the attachment list (names, types, sizes). Pass an id from teams_search_email results — search returns only a short preview, use this to read the whole message. The body is returned as readable plain text, with links listed separately. Read-only; does not mark the email as read or download attachments.
teams_send_message6 of 6 parameters describedSend a message to a Teams conversation. Use markdown for formatting (not HTML): **bold**, *italic*, ~~strikethrough~~, `code`, ```code blocks```, lists, newlines, and tables. Tables use standard markdown table syntax: | Item | Price | |------|-------| | Apple | $1.00 | (with a header row, a |---|---| separator row, then data rows — they render as a real table in Teams). Supports @mentions: people with @[Name](mri) (MRI from teams_search_people) and channel tags with @[TagName](tag:tagId) (IDs from teams_get_tags). Markdown links [text](url) support http(s) and mailto. Defaults to self-notes (48:notes). For channel thread replies, provide replyToMessageId. For a new channel thread with a title, provide subject. To schedule for later, provide scheduleAt (ISO 8601). Set contentType to "text" to send content verbatim without markdown interpretation.
teams_get_favoritesno parametersGet the user's favourite/pinned conversations in Teams. Returns conversation IDs with display names (channel name, chat topic, or participant names) and type (Channel, Chat, Meeting).
teams_add_favorite1 of 1 parameter describedAdd a conversation to the user's favourites/pinned list.
teams_remove_favorite1 of 1 parameter describedRemove a conversation from the user's favourites/pinned list.
teams_save_message3 of 3 parameters describedSave (bookmark) a message in Teams. Saved messages can be accessed later from the Saved view in Teams.
teams_unsave_message3 of 3 parameters describedRemove a saved (bookmarked) message in Teams.
teams_get_chat1 of 1 parameter describedGet the conversation ID for a 1:1 chat with a person. Use this to start a new chat or find an existing one. The conversation ID can then be used with teams_send_message to send messages.
teams_create_group_chat2 of 2 parameters describedCreate a new group chat with multiple people. Returns a conversation ID for use with teams_send_message. You are automatically included as a member. For 1:1 chats, use teams_get_chat instead.
teams_edit_message4 of 4 parameters describedEdit one of your own messages (same markdown and @mention rules as teams_send_message: people @[Name](mri), channel tags @[TagName](tag:tagId) from teams_get_tags). You can only edit messages you sent.
teams_delete_message2 of 2 parameters describedDelete one of your own messages (soft delete - the message remains but content becomes empty). You can only delete messages you sent, unless you are a channel owner/moderator.
teams_get_unread1 of 1 parameter describedGet unread status. Without conversationId: one bulk API call over your recent conversations (up to 200), returns separate lists of unread chats and channels (conversationId, displayName, lastMessageFrom) plus counts. With conversationId: unread count for that chat/channel using read horizon vs recent messages.
teams_mark_read2 of 2 parameters describedMark a conversation as read up to a specific message. This updates your read position so messages up to (and including) the specified message are marked as read.
teams_get_activity2 of 2 parameters describedGet the user's activity feed - mentions, reactions, replies, and other notifications. Returns recent activity items with sender, content, and source conversation context. Pass syncState from a previous response to get only newer items.
teams_search_emoji1 of 1 parameter describedSearch for emojis by name or keyword. Returns both standard Teams emojis and custom organisation emojis, indicating which is which. Use the returned key with teams_add_reaction.
teams_add_reaction3 of 3 parameters describedAdd an emoji reaction to a message. Common reactions: like (👍), heart (❤️), laugh (😂), surprised (😮), sad (😢), angry (😠). Use teams_search_emoji to find other emojis.
teams_remove_reaction3 of 3 parameters describedRemove an emoji reaction from a message.
teams_get_saved_messages1 of 1 parameter describedGet the list of messages the user has saved (bookmarked) in Teams. Returns references to saved messages with source conversation IDs and direct links. Use teams_get_message with sourceConversationId and sourceMessageId to fetch the full message content.
teams_get_followed_threads1 of 1 parameter describedGet the list of threads the user is following in Teams. Returns references to followed threads with source conversation IDs and direct links. Use teams_get_message with sourceConversationId and sourcePostId to fetch the full post, or teams_get_thread for the full thread.
teams_get_message2 of 2 parameters describedGet a single message by ID with full content. Works for messages of any age - no retention limit. Includes reactions (individual reactors) and reactionSummary (counts per emoji) when present. Use this to resolve truncated search results, saved message stubs, or retrieve any specific message when you have the conversationId and messageId.
teams_list_chats1 of 1 parameter describedList the user's recent conversations (1:1 chats, group chats, meetings and channels), newest activity first. Returns conversationId, chatType (oneOnOne/group/meeting/channel), topic, and a preview of the last message (sender, time, text). Use the returned conversationId with teams_get_thread to read messages or teams_send_message to reply. This is the fastest way to discover active chat IDs without a search.
teams_wait_for_reply6 of 6 parameters describedBlock until a new message arrives in a conversation, then return only the new messages. Polls server-side so you make one tool call instead of repeatedly reading the thread. Read-only and idempotent: it never posts (pair it with teams_send_message), and re-running with after=nextAfter resumes from the same point. The block is capped (~110s) to stay under client timeouts; on timeout it returns timedOut=true with nextAfter — just call again to keep waiting. By default the baseline is your most recent message, so after a teams_send_message you can call this with no "after" to wait for the reply.
teams_get_meno parametersGet the current user's profile information including email, display name, and Teams ID. Useful for finding @mentions or identifying the current user.
teams_search_people2 of 2 parameters describedSearch for people in Microsoft Teams by name or email. Returns matching users with display name, email, job title, and department. Useful for finding someone to message.
teams_get_frequent_contacts1 of 1 parameter describedGet the user's frequently contacted people, ranked by interaction frequency. Useful for resolving ambiguous names (e.g., "Rob" → which Rob?) by checking who the user commonly works with. Returns display name, email, job title, and department.
teams_get_person1 of 1 parameter describedGet one or more people's profiles by MRI (e.g. "8:orgid:uuid"). Returns display name, email, job title, department, and company. Useful for resolving MRIs (e.g. from reactions or activity) to real identities. Pass multiple MRIs for batch lookup.
teams_login1 of 1 parameter describedTrigger manual login flow for Microsoft Teams. Use this if the session has expired or you need to switch accounts.
teams_statusno parametersCheck credential availability for each core Teams capability. session.exists reports whether the saved session file exists.
teams_get_meetings3 of 3 parameters describedGet meetings from your Teams calendar. Returns meetings with: subject, startTime, endTime, organizer (name/email), location, joinUrl (Teams link), threadId (use with teams_get_thread to read meeting chat), myResponse (None/Accepted/Tentative/Declined), showAs (Free/Busy), isOrganizer. Defaults to next 7 days from now. For past meetings (e.g., "summarise my last meeting"), set startDate to a past date. To find meetings with a person, get results and filter by organizer.email.
teams_get_transcript2 of 2 parameters describedGet the transcript of a Teams meeting. Requires the meeting's threadId (from teams_get_meetings). Returns formatted transcript text with timestamps and speaker names, ready for reading or summarization. The meeting must have had transcription enabled. Optionally pass meetingDate (ISO string, e.g. the startTime from teams_get_meetings) to narrow the search.
teams_get_shared_files3 of 3 parameters describedGet files and links shared in a Teams conversation. Returns file names, URLs, extensions, sizes, and who shared them. Works for channels, group chats, 1:1 chats, and meeting chats. Use the conversationId from other tools (teams_get_favorites, teams_search, teams_find_channel, teams_get_chat). Supports pagination via skipToken for conversations with many files. To save the contents of a File item locally, pass its webUrl to teams_download_file.
teams_download_file2 of 2 parameters describedDownload a Teams file to a local path. Accepts the webUrl of a File item from teams_get_shared_files (SharePoint/OneDrive: chat uploads and channel files, including Doc.aspx viewer links), or the fileUrl of an assignment attachment or submission file from teams_get_assignment (a Microsoft Graph drive-item URL). Link items, Microsoft Forms and non-SharePoint URLs are not files and cannot be downloaded. Saves the raw file to an absolute path on the MCP server machine and returns its name, size, content type and SHA-256. The parent directory must exist and existing files are never overwritten. Streams to disk with no size limit; a transfer that stalls for 30 seconds is cancelled and the partial file removed. Respects the owner's download block. Uses Microsoft Graph via the existing Teams session (no extra sign-in); if Graph is unavailable only this tool fails, and no other Teams tool is affected.
teams_get_tags2 of 2 parameters describedGet tags for a Teams team. Returns tag IDs, display names, and member counts. Use the teamId from teams_find_channel results. Optionally filter by name with the query parameter. To @mention a tag in a message, use the tag MRI format: @[TagName](tag:{tagId}). Example: after finding tag "engineering" with id "abc123", use @[engineering](tag:abc123) in teams_send_message content.
teams_list_assignments3 of 3 parameters describedList the signed-in user's Microsoft Teams assignments across all their classes (the Teams "Assignments" tab, for EDU tenants). Active work is ordered earliest due first. Results are paged: pass nextLink back until it is absent. The service applies the page size before the status filter, so any page (not only the last) may be short or empty while more follow; keep following nextLink, or use a larger top (e.g. 100) to need fewer calls. nextLink preserves the original query, status slice and page size, and the returned statusFilter always reflects the slice actually queried. If the service cannot page further, the call returns an API_ERROR rather than repeating results. Returns each assignment's title, class ID, due date, status, max points, instructions, a Teams deep link (webUrl), and the user's own submission summary including submission state and any grade/feedback. Use statusFilter to choose which slice: 'active' (assigned and not yet completed — the default), 'completed' (turned in or returned), or 'all'. To act on or read the full detail of one result, pass its classId + id to teams_get_assignment or its submission's id to teams_submission_action. Only available on education tenants that use Assignments; on other accounts it returns an ACCESS_DENIED or AUTH_INTERACTION_REQUIRED error. That does not affect any other Teams tool, and teams_login is not needed.
teams_get_assignment2 of 2 parameters describedGet the full detail of a single Teams assignment, including instructions, due/close dates, max points, a Teams deep link, teacher attachments (name, type, and a fileUrl for files or a url for forms and links), and the signed-in user's own submission (state, grade, feedback, and their own working and turned-in files, including personal copies of attachments marked copiedForEachStudent). Download any attachment with a fileUrl using teams_download_file. Requires the classId and assignmentId, both available from teams_list_assignments (fields classId and id). Only available on education tenants that use Assignments; on other accounts it returns an ACCESS_DENIED or AUTH_INTERACTION_REQUIRED error. That does not affect any other Teams tool, and teams_login is not needed.
teams_submission_action4 of 4 parameters describedAct on the signed-in user's OWN submission for a Teams assignment. action='submit' turns it in, action='unsubmit' undoes a turn-in, action='view' marks it as viewed. This changes state on the user's real Teams account, so confirm the user's intent before calling with 'submit' or 'unsubmit'. Requires classId, assignmentId and submissionId — get classId and assignmentId from teams_list_assignments (fields classId and id) and submissionId from the submission.id in that result or from teams_get_assignment. Only available on education tenants that use Assignments; on other accounts it returns an ACCESS_DENIED or AUTH_INTERACTION_REQUIRED error. That does not affect any other Teams tool, and teams_login is not needed.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.