MULTI-APP TOOLKIT
Build with Microsoft Entra ID + Microsoft Teams
- Multi-app
- One MCP session
- 24 actions
- 6 triggers
- Managed auth
MCP
One MCP session, both toolsets
One session gives your product or agent every Microsoft Entra ID and Microsoft Teams tool at once — connect once, list tools, and call them like any single-app session.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "microsoft_entra_id,microsoft_teams",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// One list, both toolsets: Microsoft Entra ID and Microsoft Teams tools arrive
// together, each keyed by its own app's slug.
// e.g. run Add Member To Group:
const result = await mcp.callTool({
name: "microsoft_entra_id-add-member-to-group",
arguments: {
groupId: "Group",
userId: "User",
},
})import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const externalUserId = "{external_user_id}" // any stable ID for this user in your system
const [microsoftEntraIdTools, microsoftTeamsTools] =
await Promise.all([
pd.components.list({ app: "microsoft_entra_id" }),
pd.components.list({ app: "microsoft_teams" }),
])
// One external user owns both connected accounts, so either app's tools
// run on their behalf with the same externalUserId.curl "https://api.pipedream.com/v1/connect/{project_id}/components?app=microsoft_entra_id" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}"
curl "https://api.pipedream.com/v1/connect/{project_id}/components?app=microsoft_teams" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}"
# Connect both accounts to the same external_user_id, then
# configure and invoke either app's tools on that user's behalf.ARCHITECTURE
One user, two connected accounts
Your user connects each account once, under whatever ID they already have in your product. The two stay independent — either can be revoked on its own — and your code reaches both through that one user.
Your product
external_user_id
{external_user_id}Pipedream Connect
Managed identity
Auth · tools · routing
Microsoft Entra ID
Connected account
Microsoft Teams
Connected account
TOOLS
Microsoft Entra ID tools
The Microsoft Entra ID tools this pairing puts in reach, each one running on your user's own connected account.
Actions top 8 of 12
-
Add Member To Group
actionAdds a member to a group Microsoft Entra ID. See the documentationWritev0.0.7 -
Create Group
actionCreates a new group in Microsoft Entra ID. See the documentationWritev0.0.1 -
Delete Group
actionDeletes a group in Microsoft Entra ID. See the documentationWritev0.0.1 -
Get Manager
actionGet the user's manager information. Returns the user or organizational contact assigned as the user's manager. See the documentationRead-onlyv0.0.2 -
Get MS365 Groups
actionGet the user's Microsoft 365 groups (unified groups). Returns groups the user is a direct member of. See the documentationRead-onlyv0.0.2 -
Get Organization Groups
actionList all groups in the organization (excluding dynamic distribution groups). See the documentationRead-onlyv0.0.2 -
Get Organization Users
actionList all users in the organization. By default returns only enabled accounts. See the documentationRead-onlyv0.0.4 -
Get Profile
actionGet the user's profile information. Returns the signed-in user's profile by default. See the documentationRead-onlyv0.0.2
Triggers
No Microsoft Entra ID triggers are available yet.
TOOLS
Microsoft Teams tools
The Microsoft Teams tools this pairing puts in reach, each one running on your user's own connected account.
Actions top 8 of 12
-
Create Channel
actionCreate a new channel in Microsoft Teams. See the docs hereWritev0.0.12 -
Get Chat Message
actionGet a specific message from a chat. See the documentationRead-onlyv0.0.1 -
Get Current User
actionReturns the authenticated Microsoft Teams user's ID, display name, email, and principal name via Microsoft Graph. Call this first when the user says 'my channels', 'my chats', or needs identity context. Use the returnedidto identify the sender in Send Channel Message or Send Chat Message results. See the documentation.Read-onlyv0.0.2 -
List Channel Messages
actionLists messages in a Microsoft Teams channel. See the documentationRead-onlyv0.0.1 -
List Channels
actionLists all channels in a Microsoft Team. See the docs hereRead-onlyv0.0.12 -
List Chats
actionLists all chat conversations for the authenticated user. See the documentationRead-onlyv0.0.1 -
List Messages in Chat
actionGet the list of messages in a chat. See the documentationRead-onlyv0.0.1 -
List Shifts
actionGet the list of shift instances for a team. See the documentationRead-onlyv0.0.9
Triggers top 4 of 6
-
New Channel
triggerEmit new event when a new channel is created within a team. See the documentationv0.0.15 -
New Channel Message
triggerEmit new event when a new message is posted in a channel. See the documentationv0.0.15 -
New Chat
triggerEmit new event when a new chat is created. See the documentationv0.0.15 -
New Chat Message
triggerEmit new event when a new message is received in a chat. See the documentationv0.0.15
MULTI-APP
Works with more apps
The combinations customers connect alongside these two — nothing here is limited to a pair.
REFERENCE
Toolkit details
- x-pd-app-slug
- microsoft_entra_id,microsoft_teams
- Primary app
- Microsoft Entra ID (microsoft_entra_id)
- Second app
- Microsoft Teams (microsoft_teams)
- Authentication
- OAuth + OAuth
- Available actions
- 24
- Available triggers
- 6