Microsoft Teams
Team communication and collaboration for AI agents
Microsoft Teams communication and collaboration management via the Microsoft Graph API. Send messages to channels and chats, manage teams and channels, list members, and automate team collaboration workflows. Ideal for internal communications, notifications, and team management automation.
Look up data, search, list, and analyze
Create new things, update existing ones
Delete records and clean things up
List Teams
readList all teams in the organization. Returns team display name, description, visibility, and ID. Use filter for OData filtering (e.g. "displayName eq 'Engineering'") and top/skip for pagination.
Get Team
readGet detailed information about a specific team including display name, description, visibility, member settings, messaging settings, and fun settings.
List Channels
readList all channels in a team. Returns channel display name, description, membership type (standard/private/shared), and ID. Use filter for OData filtering.
Get Channel
readGet detailed information about a specific channel including display name, description, membership type, web URL, and creation date.
List Channel Messages
readGet messages from a channel. Returns message content, sender info, timestamps, and reactions. Messages are ordered by creation time descending. Use top for pagination (max 50 per request).
Get Message
readGet a specific message from a channel including its full content, sender details, timestamps, reactions, and attachments.
List Message Replies
readGet replies to a specific channel message. Returns reply content, sender info, and timestamps. Use top for pagination.
List Team Members
readList all members of a team. Returns member display name, email, user ID, and roles (owner/member/guest).
List Channel Members
readList all members of a specific channel. Especially useful for private channels where membership differs from the parent team.
Get User
readGet detailed information about a user in the organization including display name, email, job title, department, office location, and account status. Use 'me' as user_id for the signed-in user context (if delegated permissions).
List Users
readList users in the organization. Returns display name, email, job title, and account status. Use filter for OData filtering (e.g. "department eq 'Engineering'"), search for keyword search, and top/skip for pagination.
List Chats
readList chats for a specific user. Returns chat type (oneOnOne/group/meeting), topic, last updated time, and member info. Requires a user_id since application permissions are used.
Get Chat
readGet detailed information about a specific chat including chat type, topic, creation time, last updated time, and members.
List Chat Messages
readGet messages from a specific chat. Returns message content, sender info, timestamps, and attachments. Messages are ordered by creation time descending. Use top for pagination.
Send Channel Message
writeSend a message to a channel in a team. Supports plain text and HTML content. The message appears as sent by the application. Use content_type 'html' for rich formatting with bold, italic, links, and lists.
Reply To Message
writeReply to a specific message in a channel. The reply appears as a threaded response under the original message. Supports plain text and HTML content.
Send Chat Message
writeSend a message in a chat (1:1 or group). Supports plain text and HTML content. Use list_chats to find the chat_id for a specific conversation.
Create Channel
writeCreate a new channel in a team. Channels can be standard (visible to all team members), private (invite-only), or shared (cross-team). Standard channels are visible immediately; private channels require explicit member management.
Create Chat
writeCreate a new chat conversation. For oneOnOne chats, provide exactly 2 member user IDs. For group chats, provide 2 or more members and optionally a topic. Members must be specified as user IDs (GUIDs) or UPNs (emails).
Update Channel
writeUpdate a channel's display name or description. Cannot update the General channel's display name. Cannot change the membership type after creation.
Add Team Member
writeAdd a user as a member or owner of a team. The user must exist in the organization's Azure AD. Use list_users to find user IDs.
Add Channel Member
writeAdd a user as a member of a private or shared channel. Only applicable for private/shared channels; standard channel membership is inherited from the team.
Delete Channel
deleteDelete a channel from a team. This permanently removes the channel and all its content including messages, files, and tabs. The General channel cannot be deleted.
Remove Team Member
deleteRemove a member from a team. The user will lose access to all team channels and content. Use list_team_members to find the membership_id.
Delete Chat Message
deleteSoft-delete a message from a chat. The message content is replaced with a deletion notice visible to all chat participants. Requires application permissions for chat message deletion.
Connection details
Ready to connect Microsoft Teams?
Sign up free and let your AI work with this service today.
Get Started