Teams MCP
A Model Context Protocol server that provides AI assistants with access to Microsoft Teams, enabling interaction with teams, channels, chats, and organizational data through Microsoft Graph APIs.
What is Teams MCP?
Teams MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that provides ai assistants with access to microsoft teams, enabling interaction with teams, channels, chats, and organizational data through microsoft graph apis.
A Model Context Protocol server that provides AI assistants with access to Microsoft Teams, enabling interaction with teams, channels, chats, and organizational data through Microsoft Graph APIs.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that provides AI assistants
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @floriscornel/teams-mcpManual Installation
npx -y @floriscornel/teams-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Teams MCP
Teams MCP is a Model Context Protocol server that connects AI assistants to Microsoft Teams via the Microsoft Graph API, exposing 26 tools for reading and writing across teams, channels, chats, messages, and files. Read operations include browsing team lists, retrieving channel messages with automatic HTML-to-Markdown conversion, searching content with KQL queries, and downloading files. Write operations let the AI send formatted messages, create chats, upload files with resumable transfers for items over 4MB, and reply to threads. It is built for organizations that want to integrate Teams communication into AI-driven workflows without custom Graph API code.
Prerequisites
- Node.js 18 or higher installed
- A Microsoft 365 account with access to Microsoft Teams
- Permissions to complete an OAuth consent flow (the server handles this interactively)
- An MCP-compatible client such as Claude Desktop or Cursor
Add the server to your MCP client configuration
Add the teams-mcp server to your claude_desktop_config.json. No environment variables are required upfront — authentication is handled interactively on first run.
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": ["-y", "@floriscornel/teams-mcp@latest"]
}
}
}Run the authentication flow
Run the authenticate command once to complete the Microsoft OAuth flow. This opens a browser window where you sign in to your Microsoft 365 account and grant the required permissions. The token is cached at ~/.teams-mcp-token-cache.json.
npx @floriscornel/teams-mcp@latest authenticateEnable read-only mode (optional)
If you want to prevent write operations and use minimal permissions, set the TEAMS_MCP_READ_ONLY environment variable. This restricts the server to the 16 read-only tools.
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": ["-y", "@floriscornel/teams-mcp@latest"],
"env": {
"TEAMS_MCP_READ_ONLY": "true"
}
}
}
}Restart your MCP client
Restart Claude Desktop or Cursor. The server will load the cached OAuth token from ~/.teams-mcp-token-cache.json and make all 26 tools available.
Verify the connection
Ask your AI assistant to list your Teams or describe who you are. The server will call the Microsoft Graph /me endpoint to confirm the token is valid.
Teams MCP Examples
Client configuration
Full-access configuration for claude_desktop_config.json. Run the authenticate command first, then add this config.
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": ["-y", "@floriscornel/teams-mcp@latest"]
}
}
}Prompts to try
Use these after authenticating to interact with Microsoft Teams through your AI assistant.
- "List all the Microsoft Teams I'm a member of."
- "Show me the last 10 messages in the #general channel of the Engineering team."
- "Send a message to the #announcements channel: 'Deployment complete at 3pm'."
- "Search Teams messages for mentions of 'Q3 budget' from the last week."
- "Create a new group chat with [email protected] and [email protected]."
- "Upload the file report.pdf to the Documents folder in the Marketing team."Troubleshooting Teams MCP
Authentication fails or the OAuth consent screen does not appear
Run 'npx @floriscornel/teams-mcp@latest authenticate' from a terminal where a browser can open. Ensure your Microsoft 365 account has not been restricted from granting third-party app consents by your IT admin.
Token expired and the server returns 401 errors
Delete the cached token file at ~/.teams-mcp-token-cache.json and re-run 'npx @floriscornel/teams-mcp@latest authenticate' to get a fresh token.
Write operations fail with permission denied
If TEAMS_MCP_READ_ONLY is set to true, write tools are disabled. Remove that env var or set it to false. Also confirm your Microsoft 365 account has permission to post in the target channel.
Frequently Asked Questions about Teams MCP
What is Teams MCP?
Teams MCP is a Model Context Protocol (MCP) server that model context protocol server that provides ai assistants with access to microsoft teams, enabling interaction with teams, channels, chats, and organizational data through microsoft graph apis. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Teams MCP?
Install via npm with the command: npx -y @floriscornel/teams-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Teams MCP?
Teams MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Teams MCP free to use?
Yes, Teams MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Teams MCP Alternatives — Similar Communication Servers
Looking for alternatives to Teams MCP? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Teams MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Teams MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.