Microsoft Teams MCP
Read, search and post in Microsoft Teams chats and channels from an AI client
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.13.1
- Listing updated
- today
Similar MCP servers
About Microsoft Teams MCP
Microsoft Teams MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
Instead of an Azure app registration, this server reuses your signed-in Teams browser session. A browser bridge called fetchproxy captures a chat-service bearer token once, and every later call is a plain server-side request. The token is cached for roughly 23 hours, so a restart does not need the browser again, and a 401 triggers one re-capture.
Reading is non-destructive by default: pulling a chat or your unread messages leaves Teams badges as they were unless you ask to mark them read. Writes such as sending, editing, deleting, reacting, renaming a group chat and changing its members each wait for your confirmation. The README says the project was developed and is maintained by AI (Claude Code) and should be used at your own discretion.
Beyond chats it covers the Activity feed, inline images, SharePoint file downloads through a separate captured token, and message search through Microsoft Substrate, with a fallback that scans recent conversations when no search token is available.
Install
Run in a terminal
claude mcp add microsoft-teams-mcp --env TEAMS_ACCESS_TOKEN='<TEAMS_ACCESS_TOKEN>' --env MCP_CONFIRM_SECRET='<MCP_CONFIRM_SECRET>' -- npx -y @chrischall/microsoft-teams-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"microsoft-teams-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/microsoft-teams-mcp"
],
"env": {
"TEAMS_ACCESS_TOKEN": "<TEAMS_ACCESS_TOKEN>",
"MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"microsoft-teams-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/microsoft-teams-mcp"
],
"env": {
"TEAMS_ACCESS_TOKEN": "<TEAMS_ACCESS_TOKEN>",
"MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"microsoft-teams-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chrischall/microsoft-teams-mcp"
],
"env": {
"TEAMS_ACCESS_TOKEN": "<TEAMS_ACCESS_TOKEN>",
"MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"microsoft-teams-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/microsoft-teams-mcp"
],
"env": {
"TEAMS_ACCESS_TOKEN": "<TEAMS_ACCESS_TOKEN>",
"MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"microsoft-teams-mcp": {
"command": "npx",
"args": [
"-y",
"@chrischall/microsoft-teams-mcp"
],
"env": {
"TEAMS_ACCESS_TOKEN": "<TEAMS_ACCESS_TOKEN>",
"MCP_CONFIRM_SECRET": "<MCP_CONFIRM_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TEAMS_WS_PORTfetchproxy concentrator port used for the browser bridge. Defaults to 37149, the fleet-wide shared port.FETCHPROXY_WS_HOSTBind interface for the bridge (default 127.0.0.1; a literal IP only, anything else is ignored). Keep on loopback — it exists for ONE topology: a hosted child in its own network namespace.FETCHPROXY_IDENTITY_DIRWhere to store the long-term fetchproxy identity keypair (default ~/.fetchproxy/identity/; an absolute path only, anything else is ignored). Exists for a host that runs a separate child per caller, so they can share one identity.TEAMS_ACCESS_TOKENA pre-obtained Teams chat-service bearer token (the JWT itself). Leave blank to capture one from your signed-in Teams browser tab via the ContextMint Bridge extension.TEAMS_DISABLE_FETCHPROXYSet to true to never capture a token from the browser; then TEAMS_ACCESS_TOKEN is required. Leave blank.TEAMS_CHATSVC_REGIONThe Teams chat-service region in the API path. Defaults to amer. Leave blank unless your tenant lives elsewhere.TEAMS_CHATSVC_BASEFull override for the chat-service API base (default https://teams.cloud.microsoft/api/chatsvc/<region>/v1). Leave blank.TEAMS_CAPTURE_TIMEOUTSeconds to wait for the Teams tab to issue a chat-service request when capturing a token. Defaults to 30.TEAMS_TOKEN_CACHESet to false to keep the captured token in memory only. Defaults to on: it is cached so a restart within its ~23h lifetime needs no browser.TEAMS_TOKEN_FILEWhere the captured token is cached. Defaults to ~/.microsoft-teams-mcp/token.json.TEAMS_SUBSTRATE_TOKEN_FILEWhere the captured Substrate search token is cached. Defaults to ~/.microsoft-teams-mcp/substrate-token.json.TEAMS_RECAP_TOKEN_FILEWhere the captured meeting-recap token is cached. Defaults to ~/.microsoft-teams-mcp/recap-token.json.TEAMS_MCPS_REGIONThe region in the Teams meeting-recap API path (teams.cloud.microsoft/api/mcps/<region>). Defaults to us. Leave blank unless your tenant lives elsewhere.TEAMS_SHAREPOINT_TOKEN_FILEWhere the captured SharePoint tokens are cached. Defaults to ~/.microsoft-teams-mcp/sharepoint-tokens.json.TEAMS_TIME_ZONEDefault IANA time zone (e.g. America/New_York) for time_local on read results. Unset means UTC only.TEAMS_OUTPUT_DIRFolder teams_export_messages writes exports into. Unset means ~/Downloads/microsoft-teams-mcp.MCP_CONFIRM_MODEWhat the writes (teams_send_message, teams_edit_message, teams_delete_message, teams_react, teams_mark_read, teams_rename_chat, teams_add_chat_members, teams_remove_chat_members, teams_create_group_chat and the read tools' mark_read) do on a client that cannot show a confirmation prompt (claude.ai, Claude Desktop): "ask-user" (default: the first call returns a preview and a confirmToken, and the model must get your approval in chat before using it), "auto" (the model may use the token after reviewing the preview itself) or "refuse". An unrecognised value is treated as refuse.MCP_CONFIRM_ELICITATION"off" never shows a confirmation prompt, so every client gets the MCP_CONFIRM_MODE flow. Set it for a client that says it can show prompts but never does. Defaults to on.MCP_CONFIRM_TTL_SECONDSHow long a confirmToken stays valid, in seconds. Defaults to 600.MCP_CONFIRM_SECRETSigning key for confirmTokens. Random per process by default; set it only if tokens must survive a server restart.
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- teams_list_activity
- Reads your Teams Activity feed.
- teams_mark_read
- Moves your read marker forward.
- teams_list_messages
- Lists messages in a chat or channel, optionally marking them read.
- teams_list_unread_messages
- Pulls unread messages.
- teams_send_message
- Posts a message after confirmation.
- teams_edit_message
- Edits a message.
- teams_delete_message
- Deletes a message.
- teams_react
- Adds a reaction.
- teams_rename_chat
- Renames a group chat.
- teams_add_chat_members
- Adds people to a group chat.
- teams_remove_chat_members
- Removes people from a group chat.
- teams_create_group_chat
- Starts a new group chat.
- teams_get_attachment
- Downloads a shared file or inline image.
- teams_export_messages
- Exports messages to a local folder.
- teams_search_messages
- Searches messages through Substrate.
- teams_get_meeting_recap
- Fetches a meeting recap.
What it does
- Read chats and channels
- List every chat and channel you are in and read any of them by id or name.
- Unread message pull
- Fetch everything you have not read yet without changing unread badges unless asked.
- Confirmed writes
- Send, edit, delete and react to messages, and manage group chats, only after you confirm.
- Substrate message search
- Search messages the way the Teams search box does, with a scan fallback.
- SharePoint attachments
- Download files shared in chats, or save them to a local folder.
- Activity feed
- Read your Teams Activity feed like any other conversation.
Good for
- Summarise what you missed in busy Teams channels
- Find an old message or decision by keyword
- Draft and send a reply after approving it
- Download a file a colleague shared in a chat
- Set up a new group chat and add people by name or email
Pricing
Open source
Microsoft Teams MCP FAQ
Does it need an Azure app registration?
The README describes capturing a token from your signed-in Teams browser tab through the fetchproxy bridge, not an app registration.
Will reading messages mark them as read?
No. By default nothing is marked read; you have to call teams_mark_read or set mark_read to true.
Which Teams host is supported?
teams.cloud.microsoft. The old teams.microsoft.com host is not supported.
Can it change anything without asking?
Writes such as sending, editing, deleting and reacting change nothing until you confirm.
Is Microsoft Teams MCP free?
Yes. Microsoft Teams MCP is open source, so you can use and self-host it for free.
How do I add Microsoft Teams MCP to Claude Code?
Run this command in your terminal: claude mcp add microsoft-teams-mcp --env TEAMS_ACCESS_TOKEN='<TEAMS_ACCESS_TOKEN>' --env MCP_CONFIRM_SECRET='<MCP_CONFIRM_SECRET>' -- npx -y @chrischall/microsoft-teams-mcp
What are the best alternatives to Microsoft Teams MCP?
The closest alternatives to Microsoft Teams MCP are TrendRadar, Ha MCP, Concord MCP, Getmitra and note1.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

