Skip to content
MCP server

Microsoft Teams MCP

Read, search and post in Microsoft Teams chats and channels from an AI client

Runs locallyStatus and history
Install
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-mcp

Add 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.

How AIPoweredBot checks servers