
Microsoft 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 toolsPublic 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_EMAILCorporate email address for Teams authentication
TEAMS_AUTOSet to "true" to use auto-login (macOS + FIDO2)
TEAMS_HEADLESSSet to "true" to run FIDO2 auto-login without a visible browser
TEAMS_LOGINSet to "true" to use interactive browser login (all platforms)
TEAMS_TOKENsecretPre-existing Skype token for direct authentication
TEAMS_REGIONAPI region (required with TEAMS_TOKEN, auto-detected otherwise)
TEAMS_BEARER_TOKENsecretMiddle-tier bearer token for profile resolution
TEAMS_SUBSTRATE_TOKENsecretSubstrate bearer token for people/chat search
TEAMS_DEBUGSet to "true" to use Chrome debug session for token capture
TEAMS_TELEMETRYSet to "true" to enable full debug telemetry logging (contributor use; logs all inputs and outputs locally)
TEAMS_TELEMETRY_PATHOverride the telemetry output file path (default: platform-appropriate ~/Library/... or ~/.local/share/...)
TEAMS_IMAGE_DESCRIPTION_API_KEYsecretAPI key for the OpenAI-compatible vision endpoint used by teams_describe_image
TEAMS_IMAGE_DESCRIPTION_MODELModel name for teams_describe_image (defaults to gpt-4o-mini)
TEAMS_IMAGE_DESCRIPTION_BASE_URLOpenAI-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.
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