auth_status
Check the authentication status of the Microsoft Graph connection. Returns whether the user is authenticated and shows their basic profile information.
LABSCO SUMMARY
Teams stops being the tab you have to go back to.
Reading a thread, replying inside it, reacting and posting a file all run through Microsoft Graph, so the whole exchange happens where the work is. search_messages takes KQL, which turns 'what did Bob say about the migration' into a query with from: and a date window rather than ten minutes of scrolling.
What it is
A Microsoft Teams client over Microsoft Graph, 30 tools split between channel messages, chat messages, people lookup and tenant-wide search.
What you get
- Channel messages read with sender and timestamps, then sent, replied to, edited or soft-deleted, with markdown, mentions and importance levels
- The same for 1:1 and group chats, including creating a chat from a list of user emails and an optional topic
- Reactions set and removed on channel messages and chat messages alike, by Unicode emoji or by name — like, angry, sad, laugh, heart, surprised
- Files uploaded from local disk and posted, to a channel's SharePoint folder or to a chat through OneDrive, as reference attachments
- Inline content pulled back out: images and other hosted content from a channel or chat message returned as base64 with metadata
- Search across every channel and chat through the Microsoft Search API, with KQL filters such as from: and mentions:, plus a direct read of recent @mentions of you
- Directory lookups — the teams you belong to, a team's channels and members, and users found by name or email
Requirements
npx on your PATH and a Microsoft 365 account, signed in once with npx @floriscornel/teams-mcp@latest authenticate — a device-code sign-in whose tokens are cached and refresh on their own; auth_status reports whether that connection is authenticated and which profile it carries.
Setup effort
Follow the published steps
USE CASES
01
Catching up on the threads you were pulled into
Start from recent @mentions of you across channels and chats, open the replies under each one, and read the direct messages that arrived alongside them.
02
Answering inside the thread instead of starting a new one
Reply to the message that raised the question, resolve the mention IDs of the people who need to see it, and acknowledge the original with a reaction so the thread reads as handled.
03
Finding what somebody said weeks ago
Query across every channel and chat with KQL — sender, recipient, mention — then read the surrounding messages in the channel it came from.
04
Getting a finished report to the people who asked for it
Post the file into the channel that owns the work, or open a chat with the two people who need it and send it there — the upload goes to SharePoint or OneDrive and the message carries the reference.
05
Getting an image out of a message so a model can read it
Pull hosted content down from the channel message or the chat message that carries it, as base64 with its metadata, rather than asking somebody to re-send the screenshot.
06
Correcting something you already sent
Edit the message in place where the wording was wrong, or soft-delete it where it should not have gone out. Both are limited to messages you sent yourself.
30 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
create_chat
Create 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.
delete_channel_message
Soft delete a message in a channel. Only the message sender can delete their own messages. The message will be marked as deleted.
delete_chat_message
Soft delete a chat message that was previously sent. Only the message sender can delete their own messages. The message will be marked as deleted but can still be seen as '[This message has been deleted]'.
download_chat_hosted_content
Download hosted content (such as images) from a chat message. Returns the content as base64 encoded data along with metadata. Use this to retrieve images or other inline content embedded in chat messages.
download_message_hosted_content
Download hosted content (such as images) from a Teams channel message. Returns the content as base64 encoded data along with metadata. Use this to retrieve images or other inline content embedded in messages.
get_channel_message_replies
Get all replies to a specific message in a channel. Returns reply content, sender information, and timestamps.
get_channel_messages
Retrieve recent messages from a specific channel in a Microsoft Team. Returns message content, sender information, and timestamps.
get_chat_messages
Retrieve recent messages from a specific chat conversation. Returns message content, sender information, and timestamps.
get_current_user
Get the current authenticated user's profile information including display name, email, job title, and department.
get_my_mentions
Find recent messages where the current user was @mentioned across all Teams channels and chats.
get_user
Get detailed information about a specific user by their ID or email address. Returns profile information including name, email, job title, and department.
list_channels
List all channels in a specific Microsoft Team. Returns channel names, descriptions, types, and IDs for the specified team.
list_chats
List all recent chats (1:1 conversations and group chats) that the current user participates in. Returns chat topics, types, and participant information.
list_team_members
List all members of a specific Microsoft Team. Returns member names, email addresses, roles, and IDs.
list_teams
List all Microsoft Teams that the current user is a member of. Returns team names, descriptions, and IDs.
reply_to_channel_message
Reply to a specific message in a channel. Supports text and markdown formatting, mentions, and importance levels.
search_messages
Search for messages across all Microsoft Teams channels and chats using the Microsoft Search API. The query string supports KQL (Keyword Query Language) syntax for advanced filtering: from:<name> — messages sent by a person (e.g. from:bob) to:<name> — messages sent to a person mentions:<userId> — messages that mention a specific user ID (without dashes) IsMentioned:true — messages that mention the current user hasAttachment:true|false — filter by attachment presence IsRead:true|false — filter by read status sent>=YYYY-MM-DD — messages sent on or after a date sent<=YYYY-MM-DD — messages sent on or before a date Examples: "quarterly report" from:alice sent>=2025-01-01 hasAttachment:true from:bob project update sent>=2025-02-01 Use get_chat_messages or get_channel_messages for browsing a specific conversation.
search_users
Search for users in the organization by name or email address. Returns matching users with their basic profile information.
search_users_for_mentions
Search for users to mention in messages. Returns users with their display names, email addresses, and mention IDs.
send_channel_message
Send a message to a specific channel in a Microsoft Team. Supports text and markdown formatting, mentions, and importance levels.
send_chat_message
Send a message to a specific chat conversation. Supports text and markdown formatting, mentions, and importance levels.
send_file_to_channel
Upload a local file and send it as a message to a Teams channel. Supports any file type (PDF, DOCX, ZIP, images, etc.). The file is uploaded to the channel's SharePoint folder and sent as a reference attachment. If messageId is provided, the file is sent as a reply to that message (thread).
send_file_to_chat
Upload a local file and send it as a message to a Teams chat. Supports any file type (PDF, DOCX, ZIP, images, etc.). The file is uploaded to OneDrive and sent as a reference attachment.
set_channel_message_reaction
Add a reaction to a message in a Teams channel. Supports Unicode emoji characters and named reactions (like, angry, sad, laugh, heart, surprised). Can also react to replies.
set_chat_message_reaction
Add a reaction to a message in a chat conversation. Supports Unicode emoji characters and named reactions (like, angry, sad, laugh, heart, surprised).
unset_channel_message_reaction
Remove a reaction from a message in a Teams channel. Can also remove reactions from replies.
unset_chat_message_reaction
Remove a reaction from a message in a chat conversation.
update_channel_message
Update (edit) a message in a channel that was previously sent. Only the message sender can update their own messages.
update_chat_message
Update (edit) a chat message that was previously sent. Only the message sender can update their own messages. Supports updating content with text or Markdown formatting, mentions, and importance levels.
BEFORE YOU INSTALL
What to know first
Tools you get
30 tools when we connected. The documentation lists 26 and omits four message-reaction tools. TEAMS_MCP_READ_ONLY=true or --read-only disables write tools and requests only read scopes, leaving roughly 16.
Requires
- npx on PATH
- Node.js 18+
Where it runs
All 5 documented setups run the server on your machine.
CONTEXT COST
Moderate Standing cost
Rated by the size of the 30 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
First, authenticate with Microsoft Graph:
TERMINAL
npx @floriscornel/teams-mcp@latest authenticateMCP Clients
Cursor, Claude Desktop
JSON
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": [
"-y",
"@floriscornel/teams-mcp@latest"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"teams-mcp": {
"command": "npx",
"args": [
"-y",
"@floriscornel/teams-mcp@latest"
]
}
}
}Any MCP client — token
ANY MCP CLIENT — TOKEN · JSON
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": [
"-y",
"@floriscornel/teams-mcp@latest"
],
"env": {
"AUTH_TOKEN": "<YOUR_AUTH_TOKEN>"
}
}
}
}Any MCP client — read-only
ANY MCP CLIENT — READ-ONLY · JSON
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": [
"-y",
"@floriscornel/teams-mcp@latest"
],
"env": {
"TEAMS_MCP_READ_ONLY": "true"
}
}
}
}
