Skip to content

Commit 16162b3

Browse files
authored
Add Microsoft Teams MCP server (#173)
Claude-Session: https://claude.ai/code/session_01S58U7phvDgphx6ZTXuWMJQ Signed-off-by: Mohammod Al Amin Ashik <maa.ashik00@gmail.com>
1 parent ad63414 commit 16162b3

1 file changed

Lines changed: 169 additions & 0 deletions

File tree

Lines changed: 169 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,169 @@
1+
{
2+
"$schema": "../schemas/server-definition.schema.json",
3+
"id": "inditextech.teams-mcp-docker",
4+
"name": "Microsoft Teams (Docker)",
5+
"alias": "ms-teams",
6+
"description": "Connect to Microsoft Teams via Docker. Read channel messages, start and reply to threads, mention members, and list team members through an Azure AD (MS Entra ID) bot application.",
7+
"logo": "https://avatars.githubusercontent.com/u/128586778?v=4",
8+
"schema_version": "2.1",
9+
"categories": [
10+
"communication"
11+
],
12+
"tags": [
13+
"microsoft-teams",
14+
"teams",
15+
"communication",
16+
"messaging",
17+
"azure",
18+
"entra-id",
19+
"docker",
20+
"chat"
21+
],
22+
"transport": {
23+
"type": "stdio",
24+
"command": "docker",
25+
"args": [
26+
"run",
27+
"-i",
28+
"--rm",
29+
"-e",
30+
"TEAMS_APP_ID",
31+
"-e",
32+
"TEAMS_APP_PASSWORD",
33+
"-e",
34+
"TEAMS_APP_TYPE",
35+
"-e",
36+
"TEAMS_APP_TENANT_ID",
37+
"-e",
38+
"TEAM_ID",
39+
"-e",
40+
"TEAMS_CHANNEL_ID",
41+
"ghcr.io/inditextech/mcp-teams-server:latest"
42+
],
43+
"env": {
44+
"TEAMS_APP_ID": "${input:TEAMS_APP_ID}",
45+
"TEAMS_APP_PASSWORD": "${input:TEAMS_APP_PASSWORD}",
46+
"TEAMS_APP_TYPE": "${input:TEAMS_APP_TYPE}",
47+
"TEAMS_APP_TENANT_ID": "${input:TEAMS_APP_TENANT_ID}",
48+
"TEAM_ID": "${input:TEAM_ID}",
49+
"TEAMS_CHANNEL_ID": "${input:TEAMS_CHANNEL_ID}"
50+
},
51+
"metadata": {
52+
"inputs": [
53+
{
54+
"id": "TEAMS_APP_ID",
55+
"label": "Teams App ID",
56+
"description": "UUID for your MS Entra ID (Azure AD) application (client) ID used by the Teams bot.",
57+
"type": "text",
58+
"required": true,
59+
"secret": false,
60+
"placeholder": "00000000-0000-0000-0000-000000000000",
61+
"obtain": {
62+
"url": "https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade",
63+
"instructions": "1. Open the Azure Portal > Microsoft Entra ID > App registrations\n2. Register (or open) your bot application\n3. Copy the Application (client) ID from the Overview page",
64+
"button_label": "Open Azure Portal"
65+
}
66+
},
67+
{
68+
"id": "TEAMS_APP_PASSWORD",
69+
"label": "Teams App Password (Client Secret)",
70+
"description": "Client secret generated for your MS Entra ID application registration.",
71+
"type": "text",
72+
"required": true,
73+
"secret": true,
74+
"placeholder": "****************************************",
75+
"obtain": {
76+
"url": "https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade",
77+
"instructions": "1. Open the Azure Portal > Microsoft Entra ID > App registrations > your app\n2. Go to Certificates & secrets > Client secrets\n3. Create a new client secret and copy its Value (shown only once)",
78+
"button_label": "Open Azure Portal"
79+
}
80+
},
81+
{
82+
"id": "TEAMS_APP_TYPE",
83+
"label": "Teams App Type",
84+
"description": "Tenancy model of the Entra ID application: SingleTenant or MultiTenant.",
85+
"type": "select",
86+
"required": true,
87+
"secret": false,
88+
"default": "SingleTenant",
89+
"options": [
90+
{
91+
"value": "SingleTenant",
92+
"label": "SingleTenant"
93+
},
94+
{
95+
"value": "MultiTenant",
96+
"label": "MultiTenant"
97+
}
98+
]
99+
},
100+
{
101+
"id": "TEAMS_APP_TENANT_ID",
102+
"label": "Teams App Tenant ID",
103+
"description": "Tenant UUID for your Microsoft Entra ID directory. Required when using a SingleTenant app type.",
104+
"type": "text",
105+
"required": true,
106+
"secret": false,
107+
"placeholder": "00000000-0000-0000-0000-000000000000",
108+
"obtain": {
109+
"url": "https://portal.azure.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade",
110+
"instructions": "1. Open the Azure Portal > Microsoft Entra ID > Overview\n2. Copy the Tenant ID (Directory ID)",
111+
"button_label": "Open Azure Portal"
112+
}
113+
},
114+
{
115+
"id": "TEAM_ID",
116+
"label": "Team ID",
117+
"description": "MS Teams Group ID or Team ID. Found in the channel URL as the groupId parameter (https://teams.microsoft.com/l/channel/<TEAMS_CHANNEL_ID>/<name>?groupId=<TEAM_ID>&tenantId=<TEAMS_APP_TENANT_ID>).",
118+
"type": "text",
119+
"required": true,
120+
"secret": false,
121+
"placeholder": "00000000-0000-0000-0000-000000000000",
122+
"obtain": {
123+
"url": "https://github.com/InditexTech/mcp-teams-server/blob/master/doc/MS-Teams-setup.md",
124+
"instructions": "1. Open the target channel in Microsoft Teams\n2. Click the channel ... menu > Get link to channel\n3. Copy the groupId value from the URL",
125+
"button_label": "Setup Guide"
126+
}
127+
},
128+
{
129+
"id": "TEAMS_CHANNEL_ID",
130+
"label": "Teams Channel ID",
131+
"description": "MS Teams Channel ID with URL-escaped characters. Found in the channel link URL.",
132+
"type": "text",
133+
"required": true,
134+
"secret": false,
135+
"placeholder": "19%3a...%40thread.tacv2",
136+
"obtain": {
137+
"url": "https://github.com/InditexTech/mcp-teams-server/blob/master/doc/MS-Teams-setup.md",
138+
"instructions": "1. Open the target channel in Microsoft Teams\n2. Click the channel ... menu > Get link to channel\n3. Copy the channel ID segment from the URL (keep the URL-escaped characters)",
139+
"button_label": "Setup Guide"
140+
}
141+
}
142+
]
143+
}
144+
},
145+
"auth": {
146+
"type": "api_key",
147+
"instructions": "Register an Azure AD (Microsoft Entra ID) application, create a client secret, and add the bot to your Teams channel. See https://github.com/InditexTech/mcp-teams-server/blob/master/doc/MS-Teams-setup.md"
148+
},
149+
"contributor": {
150+
"name": "InditexTech",
151+
"github": "InditexTech",
152+
"url": "https://github.com/InditexTech/mcp-teams-server"
153+
},
154+
"links": {
155+
"repository": "https://github.com/InditexTech/mcp-teams-server",
156+
"homepage": "https://github.com/InditexTech/mcp-teams-server",
157+
"documentation": "https://github.com/InditexTech/mcp-teams-server/blob/master/doc/MS-Teams-setup.md"
158+
},
159+
"platforms": [
160+
"all"
161+
],
162+
"capabilities": {
163+
"tools": true,
164+
"resources": false,
165+
"prompts": false,
166+
"read_only_mode": false
167+
},
168+
"changelog_url": "https://github.com/InditexTech/mcp-teams-server/releases"
169+
}

0 commit comments

Comments
 (0)