Microsoft Teams

Note: this connector has no hand-written README yet. Only the auto-generated reference below is available. See the connector's manifest at connectors/identos.ms-teams/connector.v1.json for the source.

Manifest reference

• ID: identos.ms-teams
• Version: 1.0.0
• Resource type: urn:connector:identos:ms-teams

Supported auth modes

Type	Details
idp_passthrough	requires IdP microsoft

Setup fields

ID	Label	Default	Secret?	Notes
upstream_auth.type	Authentication	idp_passthrough	no	—

Scopes

Scope
teams:read
teams:messages:read
teams:messages:write
teams:admin

Routes

Method	Pattern	Scope	Resource template
GET	/v1.0/me/joinedTeams	teams:read	—
GET	/v1.0/teams/{team_id}	teams:read	teams://{{team_id}}
GET	/v1.0/teams/{team_id}/channels	teams:read	teams://{{team_id}}
GET	/v1.0/teams/{team_id}/channels/{channel_id}	teams:read	teams://{{team_id}}/{{channel_id}}
GET	/v1.0/teams/{team_id}/channels/{channel_id}/messages	teams:messages:read	teams://{{team_id}}/{{channel_id}}
GET	/v1.0/teams/{team_id}/channels/{channel_id}/messages/{message_id}	teams:messages:read	teams://{{team_id}}/{{channel_id}}/{{message_id}}
POST	/v1.0/teams/{team_id}/channels/{channel_id}/messages	teams:messages:write	teams://{{team_id}}/{{channel_id}}
GET	/v1.0/me/chats	teams:messages:read	—
GET	/v1.0/chats/{chat_id}/messages	teams:messages:read	teams-chat://{{chat_id}}
POST	/v1.0/chats/{chat_id}/messages	teams:messages:write	teams-chat://{{chat_id}}

MCP tools

Name	Scope	Description
list_joined_teams	teams:read	List all Microsoft Teams the signed-in user is a member of.
get_team	teams:read	Get metadata for a specific Microsoft Team by its team ID.
list_channels	teams:read	List all channels in a Microsoft Team.
get_channel	teams:read	Get metadata for a specific channel within a Microsoft Team.
list_channel_messages	teams:messages:read	List messages in a Teams channel. Returns top-level messages (replies are nested).
get_channel_message	teams:messages:read	Get a single message from a Teams channel by its message ID.
send_channel_message	teams:messages:write	Send a message to a Teams channel. Supports plain text and HTML body content.
list_chats	teams:messages:read	List all 1:1 and group chats the signed-in user participates in.
list_chat_messages	teams:messages:read	List messages in a 1:1 or group chat.
send_chat_message	teams:messages:write	Send a message to a 1:1 or group chat.

Operator data schema

Keys the operator can supply under data.pbac.operator.connectors["identos.ms-teams"].* — consumed by the connector's policy.

Key	Type	Description
restricted_channels	array	Channel IDs that are read-only for non-admin users. Members may read but cannot send messages to these channels.
allow_external_chats	boolean	When false (default), listing and reading chats with external (guest) participants is blocked. Set true to permit external chat access.