Alimenter votre agent
La commande propre à l'éditeur. Ce n'est pas un endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code n'a pas de lien d'installation pour une commande locale. Copiez la commande ci-dessous et exécutez-la dans un terminal.
claude mcp add mcp-teams -- npx -y mcp-teams@0.3.70À exécuter dans un terminal.
{ "mcpServers": { "mcp-teams": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL distante ou commande sur votre machine ? Ce qui distingue les deux installations
Exécuter sur PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LancerDe l'éditeur
An MCP server that lets AI assistants (Claude Code, Claude Desktop, Cursor and others) work with Microsoft Teams on the web in Chrome or Edge. It needs no Azure app registration and no admin consent, because it uses the session of the Teams tab you already have open.
It supports work and school (Microsoft 365) accounts. Personal Teams (teams.live.com) isn't supported.
MCP server that lets AI assistants work with Microsoft Teams (web) through a Chrome/Edge extension bridge
AI app ────stdio(MCP)──► mcp-teams server ──ws://127.0.0.1:47393──► browser extension ──► Teams tab
(loopback only; our (runs Teams' own
extension's fixed id) web API in the tab)
People in to are given by name or email and looked up like Teams' people picker; each must mean exactly one person in your organization, otherwise the matches are listed. If a chat with exactly those people already exists (for a group with a title, also that title), the message goes there instead of starting another one.
A conversation can be given as an id (19:…), as Team/Channel, as a chat title, or as a person's name for your 1:1 chat with them. A name must match exactly one conversation; otherwise the matches are listed.
Meeting data comes from the meeting chat. Teams posts an event there for each call, saying who joined and when, and a message for each recording and transcript. Transcripts are stored in the organizer's OneDrive, so read_transcript reads them with your SharePoint sign-in in a SharePoint tab. If none is open, it opens your OneDrive in a pinned background tab. You can read the transcripts of meetings you were invited to, as in Teams. There is one only when someone turned on transcription in the meeting.
Teams reports the call's length, not each person's time in it, so attendance lists who joined. Meeting chats of another organization's meetings (external: true) usually can't be read once you've left, which is how Teams works too.
The AI can only request a send. The extension then opens its own window showing where the message goes (for a new chat: who will be in it, and its title), the post it replies to and the message itself. The message is posted, and a new chat created, only if you click Send there. Closing the window, clicking Don't send, or waiting 5 minutes all mean nothing is posted.
If the AI stops waiting (it cancels, times out or loses its connection) while the window is open, the window closes and nothing is posted. If you had already clicked Send but no answer came back, the AI is told the message may have been posted and to check the chat before sending again, so it doesn't post twice.
Extensions older than 0.2.13 can't close that window, so a send that would open it in one is refused: send_message says nothing was sent and asks to update the extension. With several browsers, a send goes through when the browser picked for it is 0.2.13 or newer. If the bridge is held by another AI session running a version from before this check, that server doesn't check the browser it picks, so this session's sends are refused unless every connected browser is 0.2.13 or newer. The server keeps the installed folder up to date, so reload_extension (or reloading it on the Extensions page) is usually enough; run npx mcp-teams setup if it was loaded from another folder.
When Teams asks to slow down (HTTP 429), mcp-teams sends nothing more to that service, for that region or account, until Teams' wait is over. A call waits that out if it has time; otherwise it fails with "Teams is busy (throttled) for N s". A list that came back without some people's names says so in a note, instead of leaving them out silently.
Several AI sessions share one connection to the browser: the first one runs it, the others go through it. They check on each other every 20 s. If the session running it stops responding (its app is suspended or hung), the others' calls fail within about 40 s with "The mcp-teams hub stopped responding; try again in a few seconds", and one of them takes over. A session that stops reading what it is sent is disconnected and reconnects. The extension reconnects by itself when it hasn't heard from the server for 45 s.
You need Node.js 20 or later, and Chrome or Edge. Then, in a terminal:
npx mcp-teams setup
setup does the rest and can be run again at any time:
--yes skips the question). It only adds or updates its own teams entry, and keeps a .mcp-teams.bak copy of each file it changes. For other MCP clients, register npx -y mcp-teams@latest as a stdio server.~/.mcp-teams/extension.Restart the AI apps it registered (in Claude Code: /mcp).
You don't need to keep Teams open. When no Teams tab is open, the extension opens one itself (pinned, in the background) and waits up to a minute for it to sign in.
Teams on the web talks to several services, each with its own sign-in token: chats and messages (chatsvc), the team and chat list (csa), people (mt) and search (substrate.office.com). The extension notes the tokens Teams sends on its own requests and replays them from inside the Teams tab. They are kept in the browser's session memory and never leave the browser. Teams calls most of these services as soon as it loads. Search may only be signed in once you have used Teams' search box; until then search_messages and find_people say so.
Every AI session starts its own mcp-teams server, and they share the one extension connection. The first server owns the bridge port (role: "hub" in get_version), and later ones forward their calls through it (role: "peer"). When the hub's session ends, a peer takes over within a second. A newer server takes over from an older one. Servers of 0.2.0 and older can't do the newer handshake: after updating from them, restart AI sessions that are still open (in Claude Code: /mcp).
~/.mcp-teams/config.json is created on first run:
autoSendTo is a list of your own email addresses (or UPNs), compared without regard to case or surrounding spaces, e.g. "autoSendTo": ["[email protected]"]. With it, send_message posts without the confirmation window when the message goes to you alone: your notes-to-self chat, a chat whose only member is you, or to with just your own address. The extension decides this itself after resolving the target: it looks up your profile and posts without asking only if one of your own addresses is on the list. Anything else (other people, group chats you are in, meetings, channels, a chat or profile it can't look up) shows the window as usual. The result then says autoSent: true. A value that isn't a list of email addresses stops the server with an error. Restart the AI session after changing it.
127.0.0.1. Web pages can't connect to it, because only extension origins are accepted.~/.mcp-teams/config.json, without sending it. Setup copies it into the installed extension folder as pairing.json; both files can be read only by your user. So a program that takes the port while no AI app runs gets nothing from the extension, and a program posing as the extension gets no calls.autoSendTo set, messages to yourself alone skip it (see Configuration).*.microsoft.com, *.office.com, *.sharepoint.com and similar), but it only records requests made by the Teams tab, and only names, for api_traffic. It runs requests only in Teams tabs, and in SharePoint tabs to read transcripts.extension/background.js and the parsing in extension/teams.js.read_messages returns their links; use mcp-onedrive to download them.git clone https://github.com/HeeyunCho/mcp-teams.git
cd mcp-teams
npm install && npm run build
node dist/index.js setup # registers this copy (node dist/index.js) instead of npx
npm test # builds, then runs unit, integration and system tests (see docs/testing.md)
npm run probe -- status # calls one extension method through the bridge (see scripts/probe.mjs)
Versions are bumped automatically. On every push to main (except Markdown-only changes), the Version bump GitHub Action runs the tests, then bumps package.json, package-lock.json and extension/manifest.json, commits chore(release): vX.Y.Z and tags it. While the version is below 1.0.0, a breaking change (type!: or a BREAKING CHANGE: footer) bumps the minor version and anything else, feat: included, the patch. From 1.0.0 on it's standard semver: breaking → major, feat: → minor, anything else → patch.
Every pull request and every push to main is also scanned for committed secrets by the Secret scan GitHub Action (gitleaks). Known false positives go in .gitleaksignore.
MCP server that lets AI assistants work with Microsoft Teams (web) through a Chrome/Edge extension bridge
{ "mcpServers": { "mcp-teams": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Outils
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
MCP Teams s'exécute en local via stdio.
Dernière vérification : 2026-11-15. MCP server that lets AI assistants work with Microsoft Teams (web) through a Chrome/Edge extension bridge