TeamsBridgeMCP
Summary: An MCP server that drives Microsoft Teams through the web client's own internal REST endpoints (no Graph, no Azure app registration), reusing a Chrome/Edge sign-in session to read and act on your chats and channels.
Session management:
teams_statusreports session and endpoint-registry health;teams_loginopens Chrome so you can sign in and saves the session automatically.Discovery:
list_chats(recent chats, meeting chats, channels),list_channels(your teams and their channels),list_messages(channel/chat messages with pagination).Messaging:
send_messageposts to a chat or channel, with optionalreplyToMessageIdto reply in a channel thread;search_messagessearches across chats and channels.Files:
upload_filepushes a local file to your OneDrive Teams chat folder, shares it with chat members and posts it as a message;download_filesaves a SharePoint/OneDrive file from a message to a local path.Contacts:
start_chatopens or reopens a 1:1 or group chat by e-mail address and returns theconversationIdused by other tools.Calendar:
list_meetingslists upcoming meetings from your calendar.Not available in this schema: the README also advertises
edit_messageandreact_message, and calls the pagination parameterolderCursorinlist_messageswhere the schema exposescursor— so editing, reacting and the documented cursor name are not usable as described.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TeamsBridgeMCP list my recent Teams chats and show the latest message in each"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TeamsBridgeMCP
An MCP server for Microsoft Teams that talks to the same internal REST endpoints the Teams web client (teams.microsoft.com) uses. It does not use Microsoft Graph, so you need no Azure app registration and no admin consent. You sign in once in Chrome with your normal account and the server reuses that session.
All endpoints live in one registry file (data/endpoints.json). When Microsoft changes something, you patch that file, not the code.
Landing page with architecture diagram: https://godmodeai2025.github.io/TeamsBridgeMCP/
Independent open-source project, not affiliated with, sponsored or endorsed by Microsoft. See Trademarks. The endpoints used here are undocumented and can change at any time. Check your organization's policies before using this with a work account.
Tools
Tool | What it does |
| Session and registry status |
| Opens Chrome so you can sign in; session is saved automatically |
| Recent chats, meeting chats and channels, newest first |
| Your teams and their channels |
| Messages of a chat or channel, including attached files; |
| Send to a chat or channel (the same text to the same chat within 30 s is sent once, so a client retry does not post twice); |
| Change the text of one of your messages, attachments stay |
| Add a reaction (like, heart, laugh, surprised, sad, angry) |
| Start or reopen a chat by e-mail address |
| Search across chats and channels |
| Upload a local file to your OneDrive and post it into a chat |
| Download a file from a message (SharePoint or OneDrive links only, up to 250 MB) |
| Upcoming meetings from your calendar |
Related MCP server: Microsoft Teams MCP Server
Requirements
Node.js 20 or newer
Google Chrome or Microsoft Edge installed (
playwright-coredrives your local browser and does not download one)A Microsoft 365 account with Teams
Setup
git clone https://github.com/GodModeAI2025/TeamsBridgeMCP.git
cd TeamsBridgeMCP
npm install
npm run build
npm run login # Chrome opens, sign in, the window closes by itselfPrefer Edge? npm run login -- --browser msedge, and pass --browser msedge to the server. The commands are the same on macOS and Windows (Terminal, cmd or PowerShell).
npm run login writes data/session.json (gitignored; mode 0600 on macOS and Linux, on Windows it is protected by the folder's permissions, so keep the project inside your user profile) and keeps a browser profile in data/browser-profile/ so later sign-ins usually need no password. You can also call the teams_login tool from your agent instead.
Expired tokens (chat about 24 h, files about 1 h) are refreshed by the server itself with a headless sign-in. Only when Microsoft asks for password or MFA does it open the Chrome window again. If Microsoft asks "Stay signed in?" during the first sign-in, choose yes: on a Mac without company device sign-in the silent refresh only works then, otherwise the stored profile keeps no login. HTTP 403 is passed through unchanged: it means no access to that chat or a wrong region, and a new sign-in would not help.
Configuration
Usually nothing to configure. At sign-in the server reads the chat region, the partition and your OneDrive host from the Teams client's own requests and stores them with the session; teams_status shows them. Flags or environment variables override the detected values, flags win over the environment.
Flag | Variable | Default | When to change it |
|
| detected at sign-in | Your OneDrive host for |
|
| detected, else | Chat service region of your tenant, e.g. |
|
| detected, else | Middle-tier partition used for profiles and meetings. |
|
| found in your OneDrive | OneDrive folder Teams uses for chat uploads. The server looks for the English and German name and takes the newer one; set this if Teams runs in another language. |
|
|
| Browser for sign-in: |
|
|
| Different session location |
|
|
| Your own registry file |
Finding region and partition by hand is only needed after npm run export-session (that path does not detect them) or when every chat returns HTTP 403, which is how a wrong region shows up. Open Teams in the browser, open DevTools (Network tab), click into a chat. Requests to .../api/chatsvc/<region>/v1/... show the region, requests to .../api/mt/part/<partition>/... show the partition.
Register with an MCP client
Claude Code:
claude mcp add teams -- node /absolute/path/TeamsBridgeMCP/dist/index.jsClaude Desktop (claude_desktop_config.json) and most other clients, here with a flag that overrides a detected value:
{
"mcpServers": {
"teams": {
"command": "node",
"args": [
"/absolute/path/TeamsBridgeMCP/dist/index.js",
"--region", "emea"
]
}
}
}The same with environment variables:
{
"mcpServers": {
"teams": {
"command": "node",
"args": ["/absolute/path/TeamsBridgeMCP/dist/index.js"],
"env": { "TEAMS_BROWSER": "msedge" }
}
}
}On Windows the path in args needs forward slashes or doubled backslashes, e.g. "C:/Users/you/TeamsBridgeMCP/dist/index.js".
An unknown flag stops the server with an error, so typos show up right away.
Test
npm test # builds, checks URL expansion, starts the server and calls teams_statusThis needs no Teams session.
When an endpoint breaks: capture workflow
Tools report HTTP 404/410 or auth errors when Microsoft moved an endpoint. Re-capture it:
Start Chrome with a debug port and a separate profile (current Chrome ignores the port on the default profile):
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \ --remote-debugging-port=9222 --user-data-dir="$HOME/.teams-cdp-profile"On Windows (PowerShell):
& "$env:ProgramFiles\Google\Chrome\Application\chrome.exe" ` --remote-debugging-port=9222 --user-data-dir="$env:USERPROFILE\.teams-cdp-profile"Edge works the same, e.g.
& "${env:ProgramFiles(x86)}\Microsoft\Edge\Application\msedge.exe". Open https://teams.microsoft.com there and sign in.npm run capture -- --label messagesDo the action in Teams (open a channel, send a message, page back).
After each action set a marker:
npm run mark -- "sent message in channel X"Stop with Ctrl+C. The requests are in
captures/messages-<timestamp>.jsonl.Copy the relevant request into
data/endpoints.jsonand call the tool again.
npm run export-session exports the cookies of that debug browser to data/session.json if you prefer it over npm run login.
Registry format
{
"version": 1,
"updated": "2026-10-29T14:00:00.000Z",
"endpoints": {
"messages.send": {
"method": "POST",
"url": "https://teams.cloud.microsoft/api/chatsvc/${TEAMS_REGION}/v1/users/ME/conversations/{conversationId}/messages",
"auth": "bearer",
"tokenSource": "https://ic3.teams.office.com",
"bodyType": "json",
"params": [{ "name": "conversationId", "in": "path", "required": true }]
}
}
}${NAME}inurlis replaced by the environment variable (see Configuration){name}inurlis a path parameter; all other parameters go into the query stringauth:cookie,bearer,cookie+bearerornonebearerneedstokenSource: the audience of a token captured at sign-in (e.g.https://ic3.teams.office.com) or a cookie nameheadersvalues containing{uuid}get a fresh UUID per request
Security
data/session.jsonholds your full Teams session. Never commit or share it. If it leaks, sign out of Teams everywhere or reset your password.captures/contains request headers and bodies, including tokens. Gitignored, do not share.The server can do exactly what your signed-in account can do, nothing more.
Messages from other people are input your agent reads. Keep tool approval on in your MCP client for
send_message,edit_message,react_message,upload_fileandstart_chat, so a crafted message cannot make the agent post or share files unseen.
Limits
Undocumented endpoints, no support from Microsoft. Use at your own risk.
No real-time events (push/WebSocket); reads poll.
Meetings: list and details yes, joining or controlling no.
upload_fileuses a single PUT, which SharePoint caps at 250 MB.
Legal background
This section explains why the author considers publishing this project lawful. It is provided for transparency only and is not legal advice.
Interfaces are not protected as such. Under EU law, the functionality of a computer program, its programming language and its data formats are not protected by copyright (Court of Justice of the European Union, judgment of 2 May 2012, SAS Institute, C-406/10). This project describes and uses interfaces. It does not copy any part of Microsoft's software.
Observing a program is permitted. A lawful user may observe, study and test the functioning of a program in order to determine the ideas and principles behind it, while running it as intended (Art. 5(3) Directive 2009/24/EC, implemented in Germany as § 69d(3) UrhG). The endpoints were identified by observing the network traffic of the Teams web client during normal, authorized use. No code was decompiled or disassembled.
Reverse engineering of available products is permitted. Acquiring information by observing, studying or testing a product that has been made available to the public is lawful (Art. 3(1)(b) Directive (EU) 2016/943, implemented in Germany as § 3(1) No. 2 GeschGehG).
No protection measures are circumvented. The software only uses the session the user establishes by signing in with their own account in a regular browser. It grants no additional rights and works only with the permissions that account already has.
Contractual terms remain the user's responsibility. Terms of service of Microsoft and the policies of the organization that manages a tenant may restrict automated access. They bind the user of an account, not the publication of this source code. Each user is responsible for checking that their use complies with the terms and policies that apply to them.
Private project
TeamsBridgeMCP is a private project. The author created it entirely in their own time, with their own equipment and resources, on their own initiative. It was not created in the course of any employment, as part of any job duties, or on behalf of or commissioned by any employer, client or other organization. It contains no code, data, documents or confidential information belonging to any employer or client. No employer or organization owns, maintains, endorses or is responsible for this project.
Responsible use
Use it only with an account you are allowed to automate. On a work or school tenant, check your organization's IT and acceptable-use policies first, or ask your administrator.
Chats contain other people's messages and personal data. Do not collect, export or monitor conversations beyond what you would do by hand.
The software comes as is, without warranty (Apache License 2.0, sections 7 and 8).
Trademarks
Microsoft, Microsoft Teams, Microsoft 365, Microsoft Edge, Entra ID, OneDrive and SharePoint are trademarks of the Microsoft group of companies. Chrome is a trademark of Google LLC. They are used here only to describe what this software works with. This project is independent and not affiliated with, sponsored or endorsed by Microsoft or Google. It ships no Microsoft logos, icons or code. All other names belong to their respective owners.
License
Apache License 2.0, see LICENSE.
Legal notice
Available Tools
11 toolsdownload_fileC
Download a file from a conversation to a local path
Inputs: outPath (required), fileReference (required).
list_channelsB
List your teams and their channels (channel id works with list_messages and send_message)
Inputs: teamId.
list_chatsB
List recent conversations (chats, meeting chats, channels) of the signed-in user, newest activity first
Inputs: limit.
list_meetingsB
List meetings in your calendar from now on
Inputs: days.
list_messagesC
List messages of a channel or chat conversation
Inputs: conversationId (required), kind, limit, cursor.
search_messagesC
Search messages across chats and channels
Inputs: query (required), limit.
send_messageB
Send a message to a chat or channel; in channels pass replyToMessageId (the thread's root post id) to reply in that thread
Inputs: text (required), conversationId (required), kind, replyToMessageId.
start_chatA
Start (or reopen) a chat with people by e-mail; returns the conversationId for send_message/upload_file. One person without topic = 1:1 chat (existing one is reused), otherwise a new group chat.
Inputs: emails (required), topic.
teams_loginA
Open Chrome on Teams so the user can sign in; the session is saved automatically. Returns immediately, check teams_status afterwards.
Inputs: no named parameters.
teams_statusC
Check Teams session export and endpoint registry status
Inputs: no named parameters.
upload_fileA
Send a local file to a chat: uploads it to your OneDrive Teams chat files folder, gives the chat members read access and posts it as a message (like Teams does). Use conversationId '48:notes' to send to yourself.
Inputs: path (required), conversationId (required), name, text.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct Teams resource and action: chats, channels, messages, meetings, files, and session/auth handling. The closest pairs, list_chats vs list_channels and list_messages vs search_messages, are clearly separated by their descriptions and intended use.
Most names follow a readable snake_case verb_noun pattern such as list_chats, send_message, upload_file, and search_messages. The main deviation is teams_status and teams_login using a teams_ prefix instead of a verb, but the convention is still mostly predictable.
Eleven tools is well within a reasonable range for a Teams bridge and each tool maps to a concrete operation. Auth/status, discovery, messaging, files, and meetings are all represented without excessive fragmentation.
The surface covers core workflows: listing chats/channels/messages, sending and searching messages, starting chats, transferring files, and listing meetings. Some gaps remain around message edit/delete, channel creation, meeting creation/details, and member listing, but these are workable for the apparent bridge scope.
Related MCP Connectors
Permissioned access to Outlook, OneDrive and Teams via the user's own Microsoft account
Read email/chat conversations, messages, contacts and teams; draft, send and update threads.
Your Microsoft Teams call transcripts, with real speaker names: search, read, ask.
Your team's custom tools and skills in every agent, through one MCP connection.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to interact with Microsoft Teams through direct API calls, supporting message search, sending replies, managing favorites, and more without Azure AD registration.3,442 npm36MIT
- AlicenseAqualityDmaintenanceEnables AI agents to interact with Microsoft Teams through Microsoft Graph API, using delegated device-code authentication to act on behalf of the user.1637 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to read conversations, send messages, and manage members in Microsoft Teams via the Teams Chat Service REST API.121 npm9MIT
- AlicenseAqualityBmaintenanceEnables agents to read Microsoft Teams data and, with elevated modes, post messages, reply in threads, and send chats via Microsoft Graph, with safe-by-default permission gates.959 npmMIT