Skip to main content
Glama
ssasuoirafen

teams-mcp-server

by ssasuoirafen
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

teams-mcp-server

MCP server for Microsoft Teams via Microsoft Graph API.

Tools

Tool

Description

login / complete_login

Authenticate via device code flow

list_teams

List joined teams

list_channels

List channels in a team

list_channel_messages

List messages in a channel

list_thread_replies

List replies in a thread

send_channel_message

Send a message to a channel

reply_to_channel_message

Reply to a thread

list_chats

List chats

list_chat_messages

List messages in a chat

send_chat_message

Send a chat message

search_messages

Full-text search across chats and channels

get_user

Find a user

get_user_presence

Get user's online status

create_chat / create_group_chat

Create 1:1 or group chats

update_message / delete_message

Edit or delete messages

set_reaction / unset_reaction

Manage reactions

pin_message / unpin_message

Manage pinned messages

mark_chat_read / mark_chat_unread

Mark chat read status

list_team_members / list_channel_members / list_chat_members

List members

list_team_tags

List team tags (for @tag mentions in send/reply tools)

list_pinned_messages

List pinned messages

download_attachment

Download an inline image (hostedContents) to a temp file

Adaptive Card attachments (from bots) are automatically extracted as plain text.

Related MCP server: Teams MCP Server

Configuration

Requires an Azure AD app registration with delegated permissions for Microsoft Graph.

Claude Code (.mcp.json)

{
  "mcpServers": {
    "teams-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/ssasuoirafen/teams-mcp-server", "teams-mcp"],
      "env": {
        "TEAMS_MCP_TENANT_ID": "your-tenant-id",
        "TEAMS_MCP_CLIENT_ID": "your-client-id"
      }
    }
  }
}

Variable

Description

TEAMS_MCP_TENANT_ID

Azure AD tenant ID

TEAMS_MCP_CLIENT_ID

App registration client ID

TEAMS_MCP_SCOPES

(Optional) Comma-separated scopes

Required permissions

The app registration needs delegated Microsoft Graph permissions. By default the server requests the .default scope, so Azure issues a token covering every permission consented on the app registration. A typical set (any subset works - .default picks up whatever is consented):

User.Read, User.ReadBasic.All, Team.ReadBasic.All, TeamMember.Read.All,
Channel.ReadBasic.All, ChannelMember.Read.All, ChannelMessage.Read.All,
ChannelMessage.Send, ChannelMessage.ReadWrite, Chat.Read, Chat.ReadWrite,
Presence.Read.All, TeamworkTag.Read

These require tenant admin consent: TeamMember.Read.All, ChannelMember.Read.All, ChannelMessage.Read.All, ChannelMessage.ReadWrite. Set TEAMS_MCP_SCOPES (comma-separated) to request a narrower set; a tool that hits a missing permission returns the Graph API 403 error message.

Authentication

On first use, call the login tool. It returns a device code and URL. Open the URL in a browser, enter the code, then call complete_login. Tokens are cached in ~/.teams-mcp/token_cache.json.

Development

git clone https://github.com/ssasuoirafen/teams-mcp-server.git
cd teams-mcp-server
uv sync
uv run teams-mcp

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ssasuoirafen/teams-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server