# Microsoft Teams MCP

> Microsoft Teams MCP is an open-source MCP server for communication. Read, search and post in Microsoft Teams chats and channels from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Repository:** https://github.com/chrischall/microsoft-teams-mcp
- **MCP Registry name:** io.github.chrischall/microsoft-teams-mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/microsoft-teams-mcp
