@anupam365/ms-teams-mcp

MCP server for Microsoft Teams via the Graph API. Exposes 73 tools for managing teams, channels, chats, messages, meetings, planner, calendar, apps, tabs, scheduling, search, and authentication.

Prerequisites

• Node.js 18+
• Microsoft 365 subscription with Teams enabled
• Azure AD app registration with appropriate Graph API permissions

Setup

1. Create an Azure AD App

1. Go to Azure Portal → App Registrations → New registration
2. Name it (e.g., Teams MCP), leave redirect URI blank, click Register
3. Copy the Application (client) ID and Directory (tenant) ID

2. Add API Permissions

API Permissions → Add a permission → Microsoft Graph

Application permissions (for client-credentials auth):

| Permission | Type | Required for | |---|---|---| | Channel.Create | Application | Creating channels | | Channel.Delete.All | Application | Deleting channels | | Channel.ReadBasic.All | Application | Reading channel metadata | | ChannelMessage.Read.All | Application | Reading channel messages | | ChannelMessage.UpdatePolicyViolation.All | Application | Message policy | | Calendars.ReadWrite | Application | Creating calendar events | | Group.Create | Application | Creating teams | | Group.Read.All | Application | Listing teams | | Group.ReadWrite.All | Application | Updating teams | | Member.Read.Hidden | Application | Reading hidden memberships | | OnlineMeetings.ReadWrite.All | Application | Creating online meetings | | Team.Create | Application | Creating teams | | Team.ReadBasic.All | Application | Reading team metadata | | User.Read.All | Application | Reading user info | | User.ReadBasic.All | Application | Basic user info |

Click Grant admin consent → Yes

Delegated permissions (for device-code auth):

• Team.ReadBasic.All, Channel.ReadBasic.All, ChannelMessage.Send, ChannelMessage.Read.All, Member.Read.All, OnlineMeetings.ReadWrite.All, Calendars.ReadWrite, User.Read.All

3. Create a Client Secret

Certificates & secrets → Client secrets → New client secret → Copy the Value

Configuration

Via environment variables

TEAMS_TENANT_ID=your-tenant-id
TEAMS_CLIENT_ID=your-client-id
TEAMS_CLIENT_SECRET=your-client-secret
TEAMS_AUTH_MODE=client-credentials

For device-code auth (interactive):

TEAMS_AUTH_MODE=device-code
# No TEAMS_CLIENT_SECRET needed

For direct token (bypasses OAuth flows):

TEAMS_AUTH_TOKEN=eyJ...
# TEAMS_TENANT_ID and TEAMS_CLIENT_ID not required

Read-only mode (reduced scopes):

TEAMS_READ_ONLY=true

MCP Client Config (opencode.json)

{
  "mcpServers": {
    "microsoft-teams": {
      "command": "npx",
      "args": ["-y", "@anupam365/ms-teams-mcp"],
      "env": {
        "TEAMS_TENANT_ID": "...",
        "TEAMS_CLIENT_ID": "...",
        "TEAMS_CLIENT_SECRET": "...",
        "TEAMS_AUTH_MODE": "client-credentials"
      }
    }
  }
}

Run

npx -y @anupam365/ms-teams-mcp

Tools

Teams (8)

| Tool | Description | |---|---| | list_teams | List all teams | | get_team | Get team details | | create_team | Create a new team | | update_team | Update team metadata | | delete_team | Delete a team | | archive_team | Archive a team | | unarchive_team | Restore an archived team | | clone_team | Clone an existing team |

Channels (7)

| Tool | Description | |---|---| | list_channels | List channels in a team | | get_channel | Get channel details | | create_channel | Create a new channel | | update_channel | Update channel settings | | delete_channel | Delete a channel | | archive_channel | Archive a channel | | unarchive_channel | Restore an archived channel |

Channel Members (3)

| Tool | Description | |---|---| | list_channel_members | List channel members | | add_channel_member | Add a user to a channel | | remove_channel_member | Remove a user from a channel |

Channel Messages (5)

| Tool | Description | |---|---| | send_channel_message | Send a message (supports format, importance, @mentions) | | list_channel_messages | List recent channel messages | | reply_to_channel_message | Reply to a channel message | | update_channel_message | Edit an existing channel message | | delete_channel_message | Delete a channel message |

Chats (8)

| Tool | Description | |---|---| | list_chats | List 1-on-1 and group chats | | get_chat | Get chat details | | create_chat | Create a new 1-on-1 or group chat | | send_chat_message | Send a chat message (supports format, importance) | | list_chat_messages | List chat messages | | list_chat_members | List chat members | | add_chat_member | Add a user to a group chat | | list_chat_tabs | List tabs in a chat |

Chat Messages (2)

| Tool | Description | |---|---| | update_chat_message | Edit an existing chat message | | delete_chat_message | Delete a chat message |

Apps & Tabs (7)

| Tool | Description | |---|---| | list_available_apps | List tenant app catalog | | list_team_installed_apps | List apps installed in a team | | install_app_in_team | Install an app in a team | | uninstall_app_from_team | Remove an app from a team | | list_channel_tabs | List tabs in a channel | | add_channel_tab | Add a tab to a channel | | remove_channel_tab | Remove a tab from a channel |

Planner (4)

| Tool | Description | |---|---| | list_team_plans | List plans in a team | | list_plan_buckets | List buckets in a plan | | list_plan_tasks | List tasks in a plan | | create_planner_task | Create a new task |

Calendar & Meetings (7)

| Tool | Description | |---|---| | list_team_events | List team calendar events | | create_event | Create a team calendar event | | create_user_event | Create event on a user's calendar | | get_event | Get event details | | create_online_meeting | Create a Teams meeting | | get_online_meeting | Get meeting details | | list_online_meetings | List upcoming meetings |

Presence & Settings (4)

| Tool | Description | |---|---| | get_user_presence | Get user presence status | | get_team_settings | Get team settings | | update_team_member_settings | Update team settings | | list_team_members | List all team members |

Tags (3)

| Tool | Description | |---|---| | list_team_tags | List tags in a team | | create_tag | Create a new tag | | delete_tag | Delete a tag |

Scheduling (6)

| Tool | Description | |---|---| | list_scheduling_groups | List scheduling groups | | list_shifts | List shifts | | create_shift | Create a shift | | list_time_off_reasons | List time-off reasons | | list_time_off | List time-off entries | | list_time_off_requests | List time-off requests |

Subscriptions (3)

| Tool | Description | |---|---| | create_subscription | Create a webhook subscription | | list_subscriptions | List active subscriptions | | delete_subscription | Delete a subscription |

Search & Users (3)

| Tool | Description | |---|---| | search_users | Search users in the organization | | search_messages | Search across all Teams messages | | get_my_mentions | Get messages where you are @mentioned |

Files (1)

| Tool | Description | |---|---| | list_channel_files | List files in a channel's folder |

Auth Management (2)

| Tool | Description | |---|---| | check_auth | Check authentication status and mode | | logout | Clear cached tokens and log out |

Auth Modes

| Mode | Description | Best for | |---|---|---| | token | Direct AUTH_TOKEN env var | Testing, CI | | client-credentials | App-only, no user interaction | Automated/headless use | | device-code | Interactive browser login with persistent token cache | Personal/local use |

Token Persistence

In device-code mode, the auth record is saved to ~/.microsoft-teams-mcp/auth-record.json. On subsequent starts, the token is silently refreshed without re-prompting. If the refresh fails, the device-code prompt appears again.

Read-Only Mode

Set TEAMS_READ_ONLY=true to restrict Graph scopes to User.Read.All and Group.Read.All only. Write operations will fail.

Development

git clone <repo>
cd ms-teams-mcp
npm install
npm run dev   # watch mode
npm run build # compile

License

MIT