Teams create chat

teams__create_chat

Access

Requires a project integration connection for teams.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
chatTypestringNoChat type: oneOnOne or group
membersvalue[]YesConversation members, each like {"@odata.type": "#microsoft.graph.aadUserConversationMember", "roles": ["owner"], "[email protected]": "https://graph.microsoft.com/v1.0/users('<userIdOrUpn>')"}
topicstringNoChat title (group chats only)

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "teams__create_chat",
    "arguments": {
      "members": []
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the teams integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "chatType": {
      "type": "string",
      "description": "Chat type: oneOnOne or group"
    },
    "members": {
      "type": "array",
      "description": "Conversation members, each like {\"@odata.type\": \"#microsoft.graph.aadUserConversationMember\", \"roles\": [\"owner\"], \"[email protected]\": \"https://graph.microsoft.com/v1.0/users('<userIdOrUpn>')\"}"
    },
    "topic": {
      "type": "string",
      "description": "Chat title (group chats only)"
    }
  },
  "required": [
    "members"
  ],
  "description": "Arguments for the teams__create_chat tool."
}