name: microsoft-teams-automation
description: "Automate Microsoft Teams tasks via Rube MCP (Composio): send messages, manage channels, create meetings, handle chats, and search messages. Always search tools first for current schemas."
Microsoft Teams Automation via Rube MCP
Automate Microsoft Teams operations through Composio's Microsoft Teams toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Microsoft Teams connection via
RUBE_MANAGE_CONNECTIONS with toolkit microsoft_teams
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit microsoft_teams
- If connection is not ACTIVE, follow the returned auth link to complete Microsoft OAuth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Send Channel Messages
When to use: User wants to post a message to a Teams channel
Tool sequence:
MICROSOFT_TEAMS_TEAMS_LIST - List teams to find target team [Prerequisite]
MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS - List channels in the team [Prerequisite]
MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE - Post the message [Required]
Key parameters:
team_id: UUID of the team (from TEAMS_LIST)
channel_id: Channel ID (from LIST_CHANNELS, format: '19:...@thread.tacv2')
content: Message text or HTML
content_type: 'text' or 'html'
Pitfalls:
- team_id must be a valid UUID format
- channel_id must be in thread format (e.g., '19:abc@thread.tacv2')
- TEAMS_LIST may paginate (~100 items/page); follow @odata.nextLink to find all teams
- LIST_CHANNELS can return 403 if user lacks access to the team
- Messages over ~28KB can trigger 400/413 errors; split long content
- Throttling may return 429; use exponential backoff (1s/2s/4s)
2. Send Chat Messages
When to use: User wants to send a direct or group chat message
Tool sequence:
MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS - List existing chats [Optional]
MICROSOFT_TEAMS_LIST_USERS - Find users for new chats [Optional]
MICROSOFT_TEAMS_TEAMS_CREATE_CHAT - Create a new chat [Optional]
MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE - Send the message [Required]
Key parameters:
chat_id: Chat ID (from GET_ALL_CHATS or CREATE_CHAT)
content: Message content
content_type: 'text' or 'html'
chatType: 'oneOnOne' or 'group' (for CREATE_CHAT)
members: Array of member objects (for CREATE_CHAT)
Pitfalls:
- CREATE_CHAT requires the authenticated user as one of the members
- oneOnOne chats return existing chat if one already exists between the two users
- group chats require at least one member with 'owner' role
- member user_odata_bind must use full Microsoft Graph URL format
- Chat filter support is very limited; filter client-side when needed
3. Create Online Meetings
When to use: User wants to schedule a Microsoft Teams meeting
Tool sequence:
MICROSOFT_TEAMS_LIST_USERS - Find participant user IDs [Optional]
MICROSOFT_TEAMS_CREATE_MEETING - Create the meeting [Required]
Key parameters:
subject: Meeting title
start_date_time: ISO 8601 start time (e.g., '2024-08-15T10:00:00Z')
end_date_time: ISO 8601 end time (must be after start)
participants: Array of user objects with user_id and role
Pitfalls:
- end_date_time must be strictly after start_date_time
- Participants require valid Microsoft user_id (GUID) values, not emails
- This creates a standalone meeting not linked to a calendar event
- For calendar-linked meetings, use OUTLOOK_CALENDAR_CREATE_EVENT with is_online_meeting=true
4. Manage Teams and Channels
When to use: User wants to list, create, or manage teams and channels
Tool sequence:
MICROSOFT_TEAMS_TEAMS_LIST - List all accessible teams [Required]
MICROSOFT_TEAMS_GET_TEAM - Get details for a specific team [Optional]
MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS - List channels in a team [Optional]
MICROSOFT_TEAMS_GET_CHANNEL - Get channel details [Optional]
MICROSOFT_TEAMS_TEAMS_CREATE_CHANNEL - Create a new channel [Optional]
MICROSOFT_TEAMS_LIST_TEAM_MEMBERS - List team members [Optional]
MICROSOFT_TEAMS_ADD_MEMBER_TO_TEAM - Add a member to the team [Optional]
Key parameters:
team_id: Team UUID
channel_id: Channel ID in thread format
filter: OData filter string (e.g., "startsWith(displayName,'Project')")
select: Comma-separated properties to return
Pitfalls:
- TEAMS_LIST pagination: follow @odata.nextLink in large tenants
- Private/shared channels may be omitted unless permissions align
- GET_CHANNEL returns 404 if team_id or channel_id is wrong
- Always source IDs from list operations; do not guess ID formats
5. Search Messages
When to use: User wants to find messages across Teams chats and channels
Tool sequence:
MICROSOFT_TEAMS_SEARCH_MESSAGES - Search with KQL syntax [Required]
Key parameters:
query: KQL search query (supports from:, sent:, attachments, boolean logic)
Pitfalls:
- Newly posted messages may take 30-60 seconds to appear in search
- Search is eventually consistent; do not rely on it for immediate delivery confirmation
- Use message listing tools for real-time message verification
Common Patterns
Team and Channel ID Resolution
1. Call MICROSOFT_TEAMS_TEAMS_LIST
2. Find team by displayName
3. Extract team id (UUID format)
4. Call MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS with team_id
5. Find channel by displayName
6. Extract channel id (19:...@thread.tacv2 format)
User Resolution
1. Call MICROSOFT_TEAMS_LIST_USERS
2. Filter by displayName or email
3. Extract user id (UUID format)
4. Use for meeting participants, chat members, or team operations
Pagination
- Teams/Users: Follow @odata.nextLink URL for next page
- Chats: Auto-paginates up to limit; use top for page size (max 50)
- Use
top parameter to control page size
- Continue until @odata.nextLink is absent
Known Pitfalls
Authentication and Permissions:
- Different operations require different Microsoft Graph permissions
- 403 errors indicate insufficient permissions or team access
- Some operations require admin consent in the Azure AD tenant
ID Formats:
- Team IDs: UUID format (e.g., '87b0560f-fc0d-4442-add8-b380ca926707')
- Channel IDs: Thread format (e.g., '19:abc123@thread.tacv2')
- Chat IDs: Various formats (e.g., '19:meeting_xxx@thread.v2')
- User IDs: UUID format
- Never guess IDs; always resolve from list operations
Rate Limits:
- Microsoft Graph enforces throttling
- 429 responses include Retry-After header
- Keep requests to a few per second
- Batch operations help reduce total request count
Message Formatting:
- HTML content_type supports rich formatting
- Adaptive cards require additional handling
- Message size limit is approximately 28KB
- Split long content into multiple messages
Quick Reference
| Task |
Tool Slug |
Key Params |
| List teams |
MICROSOFT_TEAMS_TEAMS_LIST |
filter, select, top |
| Get team details |
MICROSOFT_TEAMS_GET_TEAM |
team_id |
| List channels |
MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS |
team_id, filter |
| Get channel |
MICROSOFT_TEAMS_GET_CHANNEL |
team_id, channel_id |
| Create channel |
MICROSOFT_TEAMS_TEAMS_CREATE_CHANNEL |
team_id, displayName |
| Post to channel |
MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE |
team_id, channel_id, content |
| List chats |
MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS |
user_id, limit |
| Create chat |
MICROSOFT_TEAMS_TEAMS_CREATE_CHAT |
chatType, members, topic |
| Post to chat |
MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE |
chat_id, content |
| Create meeting |
MICROSOFT_TEAMS_CREATE_MEETING |
subject, start_date_time, end_date_time |
| List users |
MICROSOFT_TEAMS_LIST_USERS |
filter, select, top |
| List team members |
MICROSOFT_TEAMS_LIST_TEAM_MEMBERS |
team_id |
| Add team member |
MICROSOFT_TEAMS_ADD_MEMBER_TO_TEAM |
team_id, user_id |
| Search messages |
MICROSOFT_TEAMS_SEARCH_MESSAGES |
query |
| Get chat message |
MICROSOFT_TEAMS_GET_CHAT_MESSAGE |
chat_id, message_id |
| List joined teams |
MICROSOFT_TEAMS_LIST_USER_JOINED_TEAMS |
(none) |
1---2name: microsoft-teams-automation-33description: <!-- AUTO-GENERATED by export-skills.py — DO NOT EDIT -->4---5<!-- AUTO-GENERATED by export-skills.py — DO NOT EDIT -->6---7name: microsoft-teams-automation8description: "Automate Microsoft Teams tasks via Rube MCP (Composio): send messages, manage channels, create meetings, handle chats, and search messages. Always search tools first for current schemas."9---1011# Microsoft Teams Automation via Rube MCP1213Automate Microsoft Teams operations through Composio's Microsoft Teams toolkit via Rube MCP.1415## Prerequisites1617- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)18- Active Microsoft Teams connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `microsoft_teams`19- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas2021## Setup2223**Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.2425261. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds272. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `microsoft_teams`283. If connection is not ACTIVE, follow the returned auth link to complete Microsoft OAuth294. Confirm connection status shows ACTIVE before running any workflows3031## Core Workflows3233### 1. Send Channel Messages3435**When to use**: User wants to post a message to a Teams channel3637**Tool sequence**:381. `MICROSOFT_TEAMS_TEAMS_LIST` - List teams to find target team [Prerequisite]392. `MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS` - List channels in the team [Prerequisite]403. `MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE` - Post the message [Required]4142**Key parameters**:43- `team_id`: UUID of the team (from TEAMS_LIST)44- `channel_id`: Channel ID (from LIST_CHANNELS, format: '19:...@thread.tacv2')45- `content`: Message text or HTML46- `content_type`: 'text' or 'html'4748**Pitfalls**:49- team_id must be a valid UUID format50- channel_id must be in thread format (e.g., '19:abc@thread.tacv2')51- TEAMS_LIST may paginate (~100 items/page); follow @odata.nextLink to find all teams52- LIST_CHANNELS can return 403 if user lacks access to the team53- Messages over ~28KB can trigger 400/413 errors; split long content54- Throttling may return 429; use exponential backoff (1s/2s/4s)5556### 2. Send Chat Messages5758**When to use**: User wants to send a direct or group chat message5960**Tool sequence**:611. `MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS` - List existing chats [Optional]622. `MICROSOFT_TEAMS_LIST_USERS` - Find users for new chats [Optional]633. `MICROSOFT_TEAMS_TEAMS_CREATE_CHAT` - Create a new chat [Optional]644. `MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE` - Send the message [Required]6566**Key parameters**:67- `chat_id`: Chat ID (from GET_ALL_CHATS or CREATE_CHAT)68- `content`: Message content69- `content_type`: 'text' or 'html'70- `chatType`: 'oneOnOne' or 'group' (for CREATE_CHAT)71- `members`: Array of member objects (for CREATE_CHAT)7273**Pitfalls**:74- CREATE_CHAT requires the authenticated user as one of the members75- oneOnOne chats return existing chat if one already exists between the two users76- group chats require at least one member with 'owner' role77- member user_odata_bind must use full Microsoft Graph URL format78- Chat filter support is very limited; filter client-side when needed7980### 3. Create Online Meetings8182**When to use**: User wants to schedule a Microsoft Teams meeting8384**Tool sequence**:851. `MICROSOFT_TEAMS_LIST_USERS` - Find participant user IDs [Optional]862. `MICROSOFT_TEAMS_CREATE_MEETING` - Create the meeting [Required]8788**Key parameters**:89- `subject`: Meeting title90- `start_date_time`: ISO 8601 start time (e.g., '2024-08-15T10:00:00Z')91- `end_date_time`: ISO 8601 end time (must be after start)92- `participants`: Array of user objects with user_id and role9394**Pitfalls**:95- end_date_time must be strictly after start_date_time96- Participants require valid Microsoft user_id (GUID) values, not emails97- This creates a standalone meeting not linked to a calendar event98- For calendar-linked meetings, use OUTLOOK_CALENDAR_CREATE_EVENT with is_online_meeting=true99100### 4. Manage Teams and Channels101102**When to use**: User wants to list, create, or manage teams and channels103104**Tool sequence**:1051. `MICROSOFT_TEAMS_TEAMS_LIST` - List all accessible teams [Required]1062. `MICROSOFT_TEAMS_GET_TEAM` - Get details for a specific team [Optional]1073. `MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS` - List channels in a team [Optional]1084. `MICROSOFT_TEAMS_GET_CHANNEL` - Get channel details [Optional]1095. `MICROSOFT_TEAMS_TEAMS_CREATE_CHANNEL` - Create a new channel [Optional]1106. `MICROSOFT_TEAMS_LIST_TEAM_MEMBERS` - List team members [Optional]1117. `MICROSOFT_TEAMS_ADD_MEMBER_TO_TEAM` - Add a member to the team [Optional]112113**Key parameters**:114- `team_id`: Team UUID115- `channel_id`: Channel ID in thread format116- `filter`: OData filter string (e.g., "startsWith(displayName,'Project')")117- `select`: Comma-separated properties to return118119**Pitfalls**:120- TEAMS_LIST pagination: follow @odata.nextLink in large tenants121- Private/shared channels may be omitted unless permissions align122- GET_CHANNEL returns 404 if team_id or channel_id is wrong123- Always source IDs from list operations; do not guess ID formats124125### 5. Search Messages126127**When to use**: User wants to find messages across Teams chats and channels128129**Tool sequence**:1301. `MICROSOFT_TEAMS_SEARCH_MESSAGES` - Search with KQL syntax [Required]131132**Key parameters**:133- `query`: KQL search query (supports from:, sent:, attachments, boolean logic)134135**Pitfalls**:136- Newly posted messages may take 30-60 seconds to appear in search137- Search is eventually consistent; do not rely on it for immediate delivery confirmation138- Use message listing tools for real-time message verification139140## Common Patterns141142### Team and Channel ID Resolution143144```1451. Call MICROSOFT_TEAMS_TEAMS_LIST1462. Find team by displayName1473. Extract team id (UUID format)1484. Call MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS with team_id1495. Find channel by displayName1506. Extract channel id (19:...@thread.tacv2 format)151```152153### User Resolution154155```1561. Call MICROSOFT_TEAMS_LIST_USERS1572. Filter by displayName or email1583. Extract user id (UUID format)1594. Use for meeting participants, chat members, or team operations160```161162### Pagination163164- Teams/Users: Follow @odata.nextLink URL for next page165- Chats: Auto-paginates up to limit; use top for page size (max 50)166- Use `top` parameter to control page size167- Continue until @odata.nextLink is absent168169## Known Pitfalls170171**Authentication and Permissions**:172- Different operations require different Microsoft Graph permissions173- 403 errors indicate insufficient permissions or team access174- Some operations require admin consent in the Azure AD tenant175176**ID Formats**:177- Team IDs: UUID format (e.g., '87b0560f-fc0d-4442-add8-b380ca926707')178- Channel IDs: Thread format (e.g., '19:abc123@thread.tacv2')179- Chat IDs: Various formats (e.g., '19:meeting_xxx@thread.v2')180- User IDs: UUID format181- Never guess IDs; always resolve from list operations182183**Rate Limits**:184- Microsoft Graph enforces throttling185- 429 responses include Retry-After header186- Keep requests to a few per second187- Batch operations help reduce total request count188189**Message Formatting**:190- HTML content_type supports rich formatting191- Adaptive cards require additional handling192- Message size limit is approximately 28KB193- Split long content into multiple messages194195## Quick Reference196197| Task | Tool Slug | Key Params |198|------|-----------|------------|199| List teams | MICROSOFT_TEAMS_TEAMS_LIST | filter, select, top |200| Get team details | MICROSOFT_TEAMS_GET_TEAM | team_id |201| List channels | MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS | team_id, filter |202| Get channel | MICROSOFT_TEAMS_GET_CHANNEL | team_id, channel_id |203| Create channel | MICROSOFT_TEAMS_TEAMS_CREATE_CHANNEL | team_id, displayName |204| Post to channel | MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE | team_id, channel_id, content |205| List chats | MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS | user_id, limit |206| Create chat | MICROSOFT_TEAMS_TEAMS_CREATE_CHAT | chatType, members, topic |207| Post to chat | MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE | chat_id, content |208| Create meeting | MICROSOFT_TEAMS_CREATE_MEETING | subject, start_date_time, end_date_time |209| List users | MICROSOFT_TEAMS_LIST_USERS | filter, select, top |210| List team members | MICROSOFT_TEAMS_LIST_TEAM_MEMBERS | team_id |211| Add team member | MICROSOFT_TEAMS_ADD_MEMBER_TO_TEAM | team_id, user_id |212| Search messages | MICROSOFT_TEAMS_SEARCH_MESSAGES | query |213| Get chat message | MICROSOFT_TEAMS_GET_CHAT_MESSAGE | chat_id, message_id |214| List joined teams | MICROSOFT_TEAMS_LIST_USER_JOINED_TEAMS | (none) |215216<!-- Source: .faos/custom/skills/devops/microsoft-teams-automation/SKILL.md -->