ServiceNow MCP Server

Instructions

Implementation Reference

• src/servicenow_mcp/tools/user_tools.py:614-683 (handler)

  The main handler function that executes the create_group tool logic: posts to ServiceNow's sys_user_group table API, builds payload from params, handles optional fields, adds members post-creation if specified, returns GroupResponse.

  def create_group(
      config: ServerConfig,
      auth_manager: AuthManager,
      params: CreateGroupParams,
  ) -> GroupResponse:
      """
      Create a new group in ServiceNow.
  
      Args:
          config: Server configuration.
          auth_manager: Authentication manager.
          params: Parameters for creating the group.
  
      Returns:
          Response with the created group details.
      """
      api_url = f"{config.api_url}/table/sys_user_group"
  
      # Build request data
      data = {
          "name": params.name,
          "active": str(params.active).lower(),
      }
  
      if params.description:
          data["description"] = params.description
      if params.manager:
          data["manager"] = params.manager
      if params.parent:
          data["parent"] = params.parent
      if params.type:
          data["type"] = params.type
      if params.email:
          data["email"] = params.email
  
      # Make request
      try:
          response = requests.post(
              api_url,
              json=data,
              headers=auth_manager.get_headers(),
              timeout=config.timeout,
          )
          response.raise_for_status()
  
          result = response.json().get("result", {})
          group_id = result.get("sys_id")
  
          # Add members if provided
          if params.members and group_id:
              add_group_members(
                  config,
                  auth_manager,
                  AddGroupMembersParams(group_id=group_id, members=params.members),
              )
  
          return GroupResponse(
              success=True,
              message="Group created successfully",
              group_id=group_id,
              group_name=result.get("name"),
          )
  
      except requests.RequestException as e:
          logger.error(f"Failed to create group: {e}")
          return GroupResponse(
              success=False,
              message=f"Failed to create group: {str(e)}",
          )

• src/servicenow_mcp/tools/user_tools.py:77-90 (schema)

  Pydantic BaseModel defining the input schema (parameters) for the create_group tool, with validation and descriptions for MCP tool schema.

  class CreateGroupParams(BaseModel):
      """Parameters for creating a group."""
  
      name: str = Field(..., description="Name of the group")
      description: Optional[str] = Field(None, description="Description of the group")
      manager: Optional[str] = Field(None, description="Manager of the group (sys_id or username)")
      parent: Optional[str] = Field(None, description="Parent group (sys_id or name)")
      type: Optional[str] = Field(None, description="Type of the group")
      email: Optional[str] = Field(None, description="Email address for the group")
      members: Optional[List[str]] = Field(
          None, description="List of user sys_ids or usernames to add as members"
      )
      active: Optional[bool] = Field(True, description="Whether the group is active")

• src/servicenow_mcp/utils/tool_utils.py:801-807 (registration)

  Tool registration in the central tool_definitions dictionary used by the MCP server: maps 'create_group' to its aliased handler, schema, return type hint, description, and serialization handling.

  "create_group": (
      create_group_tool,
      CreateGroupParams,
      Dict[str, Any],  # Expects dict
      "Create a new group in ServiceNow",
      "raw_dict",
  ),

• src/servicenow_mcp/tools/__init__.py:67-72 (registration)

  Re-export of create_group from user_tools.py in the tools package __init__.py for convenient imports.

  from servicenow_mcp.tools.user_tools import (
      create_user,
      update_user,
      get_user,
      list_users,
      create_group,