maxim-mazurok avatar

Microsoft Teams API

maxim-mazurok/teams-api

Connects Claude directly to Microsoft Teams via the Chat Service REST API. You get tools to read conversations, send messages, search people, and manage team members without switching contexts. Handles auth through interactive login or FIDO2 passkeys on macOS, caches tokens in your system keychain. Built for AI agents that need to monitor channels, reply to threads, or participate in team workflows autonomously. Works as an MCP server in VS Code, Cursor, and Claude Desktop, or as a standalone CLI. If you're building automations that need to pull context from Teams chats or let Claude respond to messages on your behalf, this is the bridge.

GitHub stars
9
tools
14
auth
Secret needed
transport
STDIO
env vars
14
last updated
Oct 26, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

teams_list_conversationsList available conversations

List available conversations

No parameter schema in public metadata yet.

teams_find_conversationFind a conversation by topic or member name

Find a conversation by topic or member name

No parameter schema in public metadata yet.

teams_find_one_on_oneFind a 1:1 chat with a person

Find a 1:1 chat with a person

No parameter schema in public metadata yet.

teams_get_profilesGet user profiles, including office location

Get user profiles, including office location

No parameter schema in public metadata yet.

teams_find_peopleSearch the organization directory

Search the organization directory

No parameter schema in public metadata yet.

teams_find_chatsSearch chats by name or member

Search chats by name or member

No parameter schema in public metadata yet.

teams_search_messagesSearch messages with sender, date, and scope filters

Search messages with sender, date, and scope filters

No parameter schema in public metadata yet.

teams_get_messagesGet messages from a conversation

Get messages from a conversation

No parameter schema in public metadata yet.

teams_send_messageSend a message to a conversation

Send a message to a conversation

No parameter schema in public metadata yet.

teams_get_membersList members of a conversation

List members of a conversation

No parameter schema in public metadata yet.

teams_get_transcriptGet a meeting transcript from a recorded conversation

Get a meeting transcript from a recorded conversation

No parameter schema in public metadata yet.

teams_download_fileDownload message files and inline images

Download message files and inline images

No parameter schema in public metadata yet.

teams_describe_imageDescribe an inline Teams image with a vision model

Describe an inline Teams image with a vision model

No parameter schema in public metadata yet.

teams_whoamiGet the authenticated user's display name

Get the authenticated user's display name

No parameter schema in public metadata yet.

Sponsors

Configuration

TEAMS_EMAIL

Corporate email address for Teams authentication

TEAMS_AUTO

Set to "true" to use auto-login (macOS + FIDO2)

TEAMS_HEADLESS

Set to "true" to run FIDO2 auto-login without a visible browser

TEAMS_LOGIN

Set to "true" to use interactive browser login (all platforms)

TEAMS_TOKENsecret

Pre-existing Skype token for direct authentication

TEAMS_REGION

API region (required with TEAMS_TOKEN, auto-detected otherwise)

TEAMS_BEARER_TOKENsecret

Middle-tier bearer token for profile resolution

TEAMS_SUBSTRATE_TOKENsecret

Substrate bearer token for people/chat search

TEAMS_DEBUG

Set to "true" to use Chrome debug session for token capture

TEAMS_TELEMETRY

Set to "true" to enable full debug telemetry logging (contributor use; logs all inputs and outputs locally)

TEAMS_TELEMETRY_PATH

Override the telemetry output file path (default: platform-appropriate ~/Library/... or ~/.local/share/...)

TEAMS_IMAGE_DESCRIPTION_API_KEYsecret

API key for the OpenAI-compatible vision endpoint used by teams_describe_image

TEAMS_IMAGE_DESCRIPTION_MODEL

Model name for teams_describe_image (defaults to gpt-4o-mini)

TEAMS_IMAGE_DESCRIPTION_BASE_URL

OpenAI-compatible base URL for teams_describe_image

Readme

teams-api

AI-native Microsoft Teams integration — read conversations, send messages, and manage members via the Teams Chat Service REST API.

Designed for autonomous AI agents that need to interact with Teams: read messages, reply to people, monitor conversations, and participate in team workflows.


View the full README on GitHub

Details

Repository
github.com/maxim-mazurok/teams-api
Categories
Communication & Messaging, Search & Web Crawling
Package
teams-api
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related Communication & Messaging MCP servers

View all
1mintmcp avatarGmailmintmcp/serversA MCP server for Gmail that lets you search, read, and draft emails and replies.0stars
2parthjadhav avatarTelegram Notify Mcpparthjadhav/telegram-notify-mcpSend Telegram notifications from AI agents — text, photos, and documents.7stars
3samihalawa avatarSamihalawa Whatsapp Go Mcpsamihalawa/whatsapp-go-mcpScan QR codes and go! No more troublesome autos or APIs! Send text messages, images, links, locati…5stars
4adelaidasofia avatarMulti-workspace Slack MCP server with draft+confirm safety, vault auto-export, aadelaidasofia/slack-mcpMulti-workspace Slack MCP server with draft+confirm safety, vault auto-export, and triple-mode…1stars
5pipeworx-io avatarOutlook Calendarpipeworx-io/mcp-outlook-calendarOutlook Calendar MCP Pack1stars
6nakulben avatarWhatsApp MCP Servernakulben/whatsapp-mcpManage WhatsApp Business templates and send messages via Meta Cloud API1stars